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( NOI ) 金牌 。 他 从 中 学 开始 涉足 开 
源 开 发 ， 参 与 过 “汉典 网 ”等 许多 
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Linux 输 入 法 ibus-pinyin 的 作者 。 他 
从 2009 年 Node.js 诞 生 之 始 ， 就 一 直 
在 关注 它 的 发 展 ， 有 许多 使 用 
Node.js 建 立 网 站 的 经 验 ， 活 跃 于 
CNode 社 区 。 
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内 容 提 要 
本 书 首先 简要 介绍 Nodejs， 然 后 通过 各 种 示例 讲解 Node.js 的 基本 特性 ， 再 用 案例 式 教 学 的 方式 讲述 
如 何 用 Node.js 进行 Web 开发 ， 接 着 探讨 一 些 Node.js 进 阶 话题 ， 最 后 展示 如 何 将 一 个 Node.js 应 用 部 署 到 
生产 环境 中 。 
本 书面 问 对 Node.js 感 兴趣 ， 但 没有 基础 的 读者 ， 也 可 供 已 了 解 Nodejs， 并 对 Web 前 端 / 后 端 开发 有 
一 定 经 验 ， 同 时 想 答 试 新 技术 的 开发 者 参 芳 。 
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一 一 
EI 
这 本 书 讲 了 什么 
本 书 是 一 本 Node.js WATIA, 写 给 想 了 解 Node.js 的 开发 人 员 。 我 的 目标 是 使 读者 通 
过 阅读 本 书 , 学 会 使 用 Node.js 进行 Web 后 端 开 发 , 同时 能 熟悉 事件 驱动 的 异步 式 编 程 风格 ， 
以 便 进 一 步 了 解 Node.js 的 许多 高 级 特性 ， 以 及 它 所 应 用 的 更 多 领域 。 
本 书 共 6 章 ,， 分 别 讨论 了 Node.js 的 背景 、 安 : 
范 。 下 面 简 要 概述 各 草 的 主要 内 容 。 

第 1 章 “Node.js 


Ar 
简介 ?” 


安 儿 和 配置 方法 、 基 本 特性 、 核 心 模块 以 及 一 
些 进 阶 话题 。 除 此 之 外 ， 还 有 2 个 附录 ， 分 别 介绍 了 JavaScript 的 高 级 特性 和 Node.js 编程 规 


这 一 曹 概述 了 什么 是 Nodejs。 谈 过 这 章 后 ， 你 将 对 Node.js 有 一 个 基本 的 认识 ， 同 时 了 
解 它 与 JavaScript 的 闪 厚 渊源 。 
第 2 章 “ 安 装 





ATH RO Ei Node. js " 





这 一 章 讲述 了 如 何在 各 种 不 同 的 环境 下 安装 和 配置 Node.js 及 其 基本 运 
你 可 以 了 解 到 如 何 编译 Node.js， 以 及 多 版 本 管理 工具 。 
第 3 章 “Node.js 快速 入 门 ” 


这 一 章 讲解 Node.js 的 基础 知识 ， 你 将 会 学 到 如 何 使 用 Nodejs 的 基本 环境 和 工具 进行 开发 、 
运行 和 调试 。 同时, 还 会 讲解 异步 式 1/O 与 事件 式 编程 的 一 些 重要 概念 , 这 些 概念 将 
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全 书 。 


此 外 这 一 章 还 详细 介绍 了 Node.js 的 模块 和 包 的 系统 ， 这 些 都 是 开发 中 经 常会 碰 到 的 内 容 。 
第 4 章 “Node.js 核心 模块 ” 
这 一 章 以 全 局 对 象 、 基 本 工具 、 事 件 发 射 句 、 文 件 系统 和 HTTP 为 代表 , 介绍 了 Node.js 
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第 5 章 “ 使 用 Node.js 进行 Web 开发 ” 


这 一 草 是 本 书 的 实践 性 章 让 , 一 步 一 步 教 你 如 何 从 去 开始 用 Express 框 染 创 建 一 个 网 站 ， 
实现 路 由 控制 、 模 板 解 析 、 会 话 管理 、 数 据 库 访问 等 功能 ， 最 终 创建 一 个 Web 2.0 微 博 网 站 。 








第 6 章 “Node.js 进 阶 话题 ” 

这 一 章 涉及 几 个 进 阶 话题 ,包括 模块 加 载 机 制 、 控 制 流 分 析 和 优化 、 生 产 环境 的 应 用 部 
署 等 内 容 ， 最 后 还 讨论 了 Node,js 适用 的 范围 ， 大 助 谈 者 在 今后 的 开发 中 作出 更 好 的 取舍 。 
附录 A“JavaScript 的 高 级 特性 ” 


这 个 附录 介绍 了 JavaScript 的 一 些 高 级 特性 , 如 晒 数 作用 域 、 财 包 和 对 象 的 操作 等 内 容 。 
这 些 特 性 在 浏览 硕 端 的 JavaScript 开发 中 并 没有 受到 应 有 的 重视 ， 而 在 Nodejs 中 却 十 分 常 
见 ， 阅 读 这 个 附录 可 以 帮助 你 更 好 地 理解 并 运用 JavaScript 进行 复杂 的 网 站 开发 。 














MB “Node.js 编程 规范 ” 


这 个 附录 介绍 了 Nodejjs 代码 风 格 的 一 些 约定 ， 订 守 这 些 约定 可 以 让 你 的 代码 更 清晰 、 
易 懂 ,同时 也 有 利于 接口 开发 的 统一 。 该 附录 还 分 享 了 一 些 开发 经 验 ， 可 以 让 程序 避免 很 多 
意外 错误 和 性 能 损失 。 
谁 应 该 阅读 本 书 

本 书 的 目标 读者 是 想 要 学 习 Node.js， 但 没有 任何 系统 的 经 验 的 开发 者 。 如 果 你 听 说 过 
Node.js， 并 被 它 许 多 神奇 的 特性 吸引 ， 那么 这 本 书 就 是 为 你 准备 的 。 通 过 阅读 本 书 ， 你 可 以 
对 Node.js 有 全 面 的 认识 , 学 会 如 何 用 Node.js 编程 ， 了 解 事 件 驱 动 、 异 步 式 VO 的 编程 模式 ， 
同时 还 可 以 掌握 一 些 使 用 JavaScript HÍT PRAGA ZEE HJ 71 1 o 

本 书 假设 读者 已 经 学 过 至 少 一 门 编程 语言 , 对 基本 的 程序 设计 语言 概念 ( 如 变量 、 函 数 、 
递归 、 对 象 ) 有 所 了 解 。 如 有 果 你 是 首次 学 习 编 程 语言 ,我 建议 你 先 学 一 门 第 见 的 且 容 易 入 门 
的 语言 ， 如 Java 或 C。 


如 何 阅 读本 书 


Xo ss JavaScript 的 读者 将 很 容易 学 会 Nodejs 的 许多 特性 ， 包 括 事 件 式 编程 、 
Bg. ys eR. 因为 这 些 特性 已 经 在 浏览 硕 中 被 广泛 应 用 。 同 时 , 你 还 可 以 学 到 Node.js 
































在 Web 开发 中 的 服务 融 端 与 浏 览 需 端的 结合 方式 , 这 无 论 是 对 前 庙 设计 还 是 后 端 开 发 都 是 有 
利 的 。 你 还 会 对 JavaScript 有 一 个 全 新 的 认识 ， 因 为 服务 端的 JavaScript 中 没有 DOM 和 
BOM, EAEN VS di REB EE TE [HE 

不 熟悉 JavaScript 但 是 了 解 C、Java、C++、C# 的 读者 将 很 容易 学 会 JavaScript 的 语言 特 
性 及 Node.js 的 基本 机 制 ， 如 模块 和 包 。 你 需要 关注 的 仅仅 是 JavaScript 语言 的 特别 之 处 ， 
以 及 服务 融 闪 开发 中 需要 注意 的 一 些 要 点 。 

已 经 非常 了 解 Web 后 端 开 发 ( 如 PHP, ASP.net, Ruby on Rails, Django 等 ) 的 读者 ， 
本 书 将 通过 Nodejs 给 你 一 个 不 同 的 视野 。 你 会 发 现 Node.js 和 这 些 传统 的 框架 有 很 大 的 区 
别 ， 因 为 它 使 用 了 事件 式 编程 和 异步 TO， 所 以 你 需要 改变 一 些 已 有 的 思维 方式 。 同 时 ， 你 
还 能 享受 到 Web 前 后 端 紧 密 配合 带 来 的 新 鲜 感 ， 并 可 能 对 Ajax 有 全 新 的 认识 。 

如 采 是 完全 没有 接触 过 JavaScript 的 读者 , 那么 我 建议 你 看 完 本 书 的 前 两 草 以 后 , 花 点 时 
间 到 http://www.w3school.com.cn/js/ 网 站 看 看 JavaScript 的 入 门 教程 。 你 只 要 了 解 基础 知识 驶 
行 了 ,本 书 并 不 要 求 你 学 成 一 个 JavaScript 专 家 。 在 这 之 后 请 阅读 本 书 的 附录 A， 了 解 一 下 实 
际 开 发 中 可 能 会 遇 到 的 稍微 复杂 的 语言 特性 。 附 录 A 是 为 本 书 量 映 定做 的 ， 你 可 以 从 中 很 快 
地 学 会 Node.js 经 稼 使 用 到 的 那些 特性 。 如 果 你 想 更 加 深入 系统 地 学 习 JavaScript， 推 荐 阅读 
Mozilla JavaScript 指 南 http:/developermozilla.org/en/JavaScripVGuide。 

本 书 从 第 3 章 开 始 ， 将 介绍 如 何 用 Node.js 开发 ， 你 应 该 仔细 阅读 这 一 草 。 第 4 章 是 一 些 
最 基本 的 模块 介绍 , WN Node.js 模块 的 基本 风格 , 这 可 能 会 帮助 你 理解 后 面 介 绍 的 API。 第 
5$ 曹 是 一 个 真 枪 实弹 的 实战 演练 , 跟随 这 一 草 的 每 个 步骤 你 就 可 以 用 Node.js 实现 一 个 真正 的 
Web 应 用 ,体验 开发 的 成 就 感 。 第 6 章 则 是 一 些 进 阶 话题 ， 你 会 在 这 里 接触 到 Node.js 的 一 些 
诛 层 次 概念 ， 同 时 你 还 将 学 会 如 何 真 正 部 着 Node.js FB. 

本 书 的 每 一 草 最 后 都 有 一 个 参考 资料 小 节 ,， 里 面 有 很 多 有 价值 的 资料 ,如果 感 兴趣 不 妨 
继续 深入 阅读 ,在 阅读 本 书 的 过 程 中 , 我 建议 你 抽 时 间 看 看 附录 B, 在 这 里 你 会 了 解 到 Node.js 
开发 的 一 些 编程 规范 ， 写 出 符合 社区 风格 的 漂亮 程序 。 



























































如 何 学 习 Node.js 


通读 本 书 ， 你 将 会 学 到 Nodejjs 的 很 多 东西 ， 但 如 果 想 完全 掌握 它 ， 我 建议 你 杀 目 尝试 
运行 本 书 中 的 每 一 段 代 人 码 。 本 书 的 所 有 代 人 码 可 以 在 http://www.byvoid.com/project/node E FR 
到 。” 除 此 之 外 ， 你 最 好 自己 用 Node.js 做 一 个 项 目 ， 因 为 通过 实践 你 会 遇 到 很 多 问题 ， 解 
次 这 些 问题 可 以 大 大 加 次 对 Node.js 的 理解 。 

注意 ， 不 要 忘 了 互联 网 网 上 的 资源 ， 比 如 Node.js 的 官方 API 文档 http://nodejs.org/api/。 
我 强烈 推荐 你 去 CNodeJS 社区 看 看 http://cnodejs.org/， 这 里 汇集 了 许 许 多 多 中 国 优 秀 的 




















CD 读者 也 可 以 到 图 灵 社 区 Cituring.com.en ) 本 书 的 页 面 上 下 载 源 代码 或 提交 勘误 。 一 一 编者 注 








Node.js 开发 者 。 他 们 每 天 都 在 讨论 着 大 量 有 关 Node.js 各 个 方面 的 话题 ， 你 可 以 在 上 面 获得 
很 多 帮助 。 同 时，CNodeJS 社区 的 网 站 也 是 用 Node.js 写成 的 ， 而 且 是 开源 的 ， 它 是 一 个 非 
常 好 的 让 你 了 解 如 何 用 Node.js 开发 网 站 的 实例 。 





体例 说 明 


本 书 正文 中 出 现 的 代码 引用 都 会 以 等 宽 字 体 标 出 , 例如 : console.1og('Node.js')。 
代码 段 会 以 段落 的 形式 用 等 宽 字 体 显 示 ， 例 如 : 


function hello() ( 
console.log('Hello, world!'); 


} 
EEXŻZF, BRAST Ehen, DII 
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(2) WÆDive into Python 的 译 者 ， 活 跃 在 linuxtoy http://linuxtoy.org/。 

(3) Rime 是 一 个 优秀 的 开源 输入 法 ， 它 不 仅 支 持 繁 体 和 简体 的 拼音 输入 ， 而 且 是 跨 平 台 的 ， 可 以 在 Windows. Linux. 
Mac 上 使 用 ， 其 网 址 是 : http://code.google.com/p/rimeime/。 
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Node.js， 或 者 Node， 是 一 个 可 以 让 JavaScript 运行 在 服务 需 端 的 平台 。 它 可 以 让 
JavaScript 脱离 浏览 器 的 束缚 运行 在 一 般 的 服务 带 环 境 下 ，, 就 像 运行 Python、 Perl, PHP, Ruby 
程序 一 样 。 你 可 以 用 Node.js 轻松 地 进行 服务 需 端 应 用 开发 ，Python 、Perl 、PHP 、Ruby 能 
做 的 事情 Node.js 几乎 都 能 做 ， 而 且 可 以 做 得 更 好 。 

Node.js 是 一 个 为 实时 Web ( Real-time Web ) 应 用 开发 而 诞生 的 平台 ， 它 从 诞生 之 初 就 充分 
考虑 了 在 实时 啊 应 、 超 大 规模 数据 要 求 下 架构 的 可 扩展 性 。 这 使 得 它 握 弃 了 传统 平台 依 徘 多 线 
程 来 实现 高 并 发 的 设计 思路 ， 而 采用 了 单线 程 、 异 步 式 IO、 事件 驱动 式 的 程序 设计 模型 。 这 些 
特性 不 仅 带 来 了 巨大 的 性 能 提升 ， 还 减少 了 多 线程 程序 设计 的 复杂 性 ， 进 而 提高 了 开发 效率 。 

Node.js 最 初 是 由 Ryan Dahl 发 起 的 开源 项 目 ， 后 来 被 Joyent 公司 注意 到 。Joyent 公司 将 
Ryan Dahl WAME F , 因此 现在 的 Node.js 由 Joyent 公司 管理 并 维护 .尽管 它 诞 生 的 时 间 ( 2009 
年 ) 还 不 长 ,但 它 的 周围 已 经 形成 了 一 个 庞大 的 生态 系统 。Node.js 有 看 强大 而 灵活 的 包 管 
理 器 (node package manager, npm), 目前 已 经 有 上 万 个 第 三 方 模块 ， 其 中 有 网 站 开发 框 染 ， 
有 MySQL, PostgreSQL, MongoDB 数据 库 接口 ， 有 模板 语言 解析 、CSS 生成 工具 、 邮 件 、 
加 密 、 图 形 、 调 试 文 持 ， 甚 至 还 有 图 形 用 户 界 面 和 操作 系统 API 工 具 。 由 VMware 公司 建立 
的 云 计 算 平台 Cloud Foundry 率先 支持 了 Node.js。2011 年 6 月 ， 微 软 宣布 与 Joyent 公司 合作 ， 
将 Node.js 移植 到 Windows， 同 时 Windows Azure 云 计 算 平 台 也 支持 Node.jso Node.js 日 前 
还 处 在 迅速 发 展 阶 段 ， 相 信和 在 不 久 的 未 来 它 一 定 会 成 为 流行 的 Web 应 用 开发 平台 。 让 我 们 从 
现在 开始 ， 一 同 探索 Node.js 的 美妙 世界 吧 





























1.1 Node.js 是 什么 


es 


Node.js 不 是 一 种 独立 的 语言 ， 与 PHP, Python, Perl, Ruby 的 “既是 语言 也 是 平台 ” 
不 同 。Node.js 也 不 是 一 个 JavaScript 框架 ， 不同 于 CakePHP、Django、Rails。Node.js 更 不 
是 浏览 句 端 的 库 ， 不 能 与 jQuery、ExtJS 相提并论 。Node.js 是 一 个 让 JavaScript 运行 在 服务 
MFRS, 它 让 JavaScript 成 为 脚本 声言 世界 的 一 等 公民 , TEHR AS WARS PHP, Python, 
Perl, Ruby 平起平坐 。 

Node.js 是 一 个 划时代 的 技术 ， 它 在 原 有 的 Web 前 闫 和 后 端 技术 的 基础 上 总 结 并 提 烁 出 
了 许多 新 的 概念 和 方法 ， 堪 称 是 十 多 年 来 Web 开发 经 验 的 集大成 者 。Node.js 可 以 作为 服务 
fI] HH FEDERE A, 5; PHP, Python, Ruby on Rails 相 比 , 它 跳 过 了 Apache, Nginx 等 HTTP 
服务 咒 ， 直 接 面 向 前 端 开 发 。Nodejs 的 许多 设计 理念 与 经 典 架构 (如 LAMP) 有 着 很 大 的 
不 同 ， 可 提供 强大 的 伸缩 能 力 ， 以 适应 21 世 纪 10 年 代 以 后 规模 越 来 越 庞大 的 互联 网 环境 。 








Node.js E JavaScript 


说 起 JavaScript， 不 得 不 让 人 想到 浏览 需 。 传 统 意义 上 ，JavaScript 是 由 ECMAScript, 
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文档 对 象 模 型 (DOM ) 和 浏览 器 对 象 模型 (BOM ) 组 成 的 ， 而 Mozilla 则 指出 JavaScript 由 
Core JavaScript 和 Client JavaScript 组 成 。 之 所 以 会 有 这 种 分 收 ， 是 因为 JavaScript 和 浏览 硕 
之 间 复 杂 的 历史 渊源 ， 以 及 其 命 途 多 外 的 发 展 历 程 所 共同 造成 的 ， 我 们 会 在 后 面 详 述 。 我们 
可 以 认为 ，Node.js 中 所 请 的 JavaScript 只 是 Core JavaScript， 或 者 说 是 ECMAScript 的 一 个 
LM, PER DOM, BOM 或 者 Client JavaScript。 这 是 因为 Node.js 43a fT TED Va as p, Br 
以 不 需要 使 用 浏览 希 中 的 许多 特性 。 

Node.js 是 一 个 让 JavaScript 运行 在 浏览 锅 之 外 的 平台 。 它 实现 了 诸如 文件 系统 、 模 块 、 
包 、 操 作 系 统 API、 网 络 通 信 等 Core JavaScript 没有 或 者 不 完善 的 功能 。 历 史上 将 JavaScript 
移植 到 浏览 锅 外 的 计划 不 止 一 个 ,但 Node.js 是 最 出 色 的 一 个 。 随 着 Node.js 的 成 功 ， 各 种 浏 
VA A" T] JavaScript 实现 逐步 兴起 ， 因 此 产生 了 CommonJS 规范 。CommonJS 试图 拟定 一 套 
完整 的 JavaScript 规范 ， 以 弥补 普通 应 用 程序 所 需 的 API， 璧 如 文件 系统 访问 、 命 令 行 、 模 
IRAE. PRESE REARIIBS&. CommonJS 制定 者 希望 众多 服务 端 JavaScript 实现 遵循 
CommonJS 规范 ， 以 便 相 互 兼容 和 代码 复 用 。Node.js HIT; 3: f f CommonJSAW yis, 但 
由 于 两 者 还 都 处 于 诞生 之 初 的 快速 变化 期 ， 也 会 有 不 一 致 的 地 方 。 

Node.js 的 JavaScript 引擎 是 V8， 来 目 Google Chrome 项 目 。V8 号 称 是 目前 世界 上 最 快 
的 JavaScript 引擎 ， 经 历 了 数 次 引擎 草 命 ， 它 的 JIT (Just-in-time Compilation， 即 时 编译 ) 
执行 速度 已 经 快 到 了 接近 本 地 代码 的 执行 速度 。Nodejs 不 运行 在 浏览 器 中 ， 所 以 也 就 不 存 
在 JavaScript 的 浏览 需 兼 容 性 问题 ， 你 可 以 放心 地 使 用 JavaScript 语言 的 所 有 特性 。 





























1.2 Node.js 能 做 什么 


正如 JavaScript HAP mM, Node.js 为 网 络 而 生 。Node.js 能 做 的 远 不 止 开 发 一 个 网 
站 那么 简单 ， 使 用 Node.js， 你 可 以 轻松 地 开发 : 
具有 复杂 逻辑 的 网 站 ; 
基于 社交 网 络 的 大 规模 Web 应 用 ; 
Web Socket 服务 从; 
TCP/UDP 套 接 字 应 用 程序 ; 
命令 行 工 具 ; 
交互 式 终端 程序 ; 
市 有 图 形 用 户 界 面 的 本 地 应 用 程序 ; 
单元 测试 工具 ; 
Q 客户 闻 JavaScript into 
Node.js 内 建 了 HTTP Jl&óg-ds Scr, Uu e DU HJ ELS T o 2 HB 3 95 1- Pop d RUICAS d 
的 组 合 。 这 和 PHP, Perl 不 一 样 ， 因 为 在 使 用 PHP 的 时 候 ， 必 须 先 搭建 一 个 Apache 之 类 的 
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HTTP 服务 硕 ， 然 后 通过 HTTP 服务 硕 的 模块 加 载 或 CGI 调用 ， 才 能 将 PHP 脚本 的 执行 结 
果 呈 现 给 用 户 。 而 当 你 使 用 Nodejs 时 ， 不 用 额外 搭建 一 个 HITP 服务 器 ， 因 为 Node.js 本 号 
就 内 建 了 一 个 。 这 个 服务 硕 不 仅 可 以 用 来 调试 代码 ,而 且 它 本 刁 就 可 以 部 署 到 产品 环境 , 它 
的 性 能 足以 满足 要 求 。 

Node.js 还 可 以 部 署 到 非 网 络 应 用 的 环境 下 ， 比 如 一 个 命令 行 工具 。Node.js 还 可 以 调用 
C/C++ 的 代码 ,这 样 可 以 充分 利用 已 有 的 请 多 曙 数 库 , 也 可 以 将 对 性 能 要 求 非 篆 高 的 部 分 用 
C/C++ 来 实现 。 


1.3 ”异步 式 |/O 与 事件 驱动 


Node.js 最 大 的 特点 就 是 采用 异步 式 VO 与 事件 驱动 的 染 构 设计 。 对 于 高 并 发 的 解决 方 
R, 传统 的 架构 是 多 线程 模型 ,也 就 是 为 每 个 业务 人 逻辑 提供 一 个 系统 线程 ,通过 系统 线程 切 
换 来 弥补 同步 式 VO 调用 时 的 时 间 开 销 。Node.js 使 用 的 是 单线 程 模 型 ， 对 于 所 有 VO 都 采用 
异步 式 的 请 求 方式 ， 避 免 了 频 楷 的 上 下 文 切换 。Nodejs 在 执行 的 过 程 中 会 维护 一 个 事件 队 
列 ， 程 序 在 执行 时 进入 事件 循环 等 待 下 一 个 事件 到 来 ， 每 个 异步 式 VO 请 求 完成 后 会 被 推送 
到 事件 队列 ， 等 竺 程序 进程 进行 处 理 。 

例如 ， 对 于 简单 而 常见 的 数据 库 查 询 操 作 ， 按 照 传统 方式 实现 的 代码 如 下 : 


























res = db.query('SELECT * from some table'); 
res.output(); 


以 上 代码 在 执行 到 第 一 行 的 时 候 , RESE, 每 待 数据 库 返 回 查 询 结 果 ， 然后 再 继续 
处 理 。 然 而 ， 巾 于 数据 库 查 询 可 能 涉及 磁盘 谈 写 和 网 络 通信 ， 其 延 时 可 能 相当 大 (长 达 几 个 
到 几 百 训 秒 ， 相 比 CPU 的 时 钟 差 了 好 几 个 数量 级 )， 线 程 会 在 这 里 阻塞 等 待 结果 返回 。 对 于 
高 并 发 的 访问 ， 一 方面 线程 长 期 阻塞 等 待 ， 另 一 方面 为 了 应 付 新 请 求 而 不 断 增 加 线程 ， 因 此 
会 浪费 大 量 系统 资源 ， 同 时 线程 的 增多 也 会 占用 大 量 的 CPU 时 间 来 处 理 内 存 上 下 文 切换 ， 
而 且 还 容易 遭受 低速 连接 攻击 。 

看 看 Node.js 是 如 何 解 决 这 个 问题 的 : 














db.query('SELECT * from some table', function(res) { 
res.output(); 


2E 


这 段 代 码 中 ab.query 的 第 二 个 参数 是 一 个 函数 ， 我 们 称 为 回调 函数 。 进 程 在 执行 到 
db.query 的 时 候 , 不 会 等 竺 结果 返回 ,而 是 直接 继续 执行 后 面 的 语句 , 直到 进入 事件 循环 。 
当 数 据 库 查询 结果 返回 时 ,会 将 事件 发 送 到 事件 队列 ， 等 到 线程 进入 事件 循环 以 后 , 才 会 调 
用 之 前 的 回调 函数 继 疆 执行 后 面 的 逻辑 。 

Node.js 的 异步 机 制 是 基于 事件 的 ， 所 有 的 人 磁盘 IO、 网络 通信 、 数 据 库 查询 都 以 非 阻 老 
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的 方式 请 求 ， 返 回 的 结 末 由 事件 循环 来 处 理 。 图 1-1 描述 了 这 个 机 制 。Node.js 进程 在 同一 时 
刻 只 会 处 理 一 个 事件 ， 完 成 后 立即 进入 事件 循环 检查 并 处 理 后 面 的 事件 。 这 样 做 的 好 处 是 ， 
CPU 和 内 存在 同一 时 间 集 中 处 理 一 件 事 ,， 同时 尽 可 能 让 耗 时 的 IO 操作 并 行 执 行 。 对 于 低速 
连接 攻击 ，Node.js 只 是 在 事件 队列 中 增加 请 求 ， 等 竺 操作 系统 的 回应 ， 因 而 不 会 有 任何 多 
线程 开销 ， 很 大 程度 上 可 以 提高 Web 应 用 的 健壮 性 ， 防 止 恶意 攻击 。 



































( armar I 事件 循环 数据 库 查询 


| 磁盘 LO | 


图 1-1 事件 循环 














这 种 异步 事件 模式 的 雌 端 也 是 显而易见 的 , 因为 它 不 符合 开发 者 的 稼 规 线 性 思路 , 往往 
需要 把 一 个 完整 的 逻辑 拆 分 为 一 个 个 事件 ,增加 了 开发 和 调试 难度 。 针 对 这 个 问题 ， Node.js 
第 三 方 模块 提出 了 很 多 解决 方案 ， 我 们 会 在 第 6 章 中 详细 讨论 。 


1.4 Node.js 的 性 能 


1.4.1 Node.js 架构 简介 

Node.js 用 异步 式 UO 和 事件 驱动 代替 多 线程 ， 带 来 了 可 观 的 性 能 提升 。Node.js 除了 使 
用 V8 作为 JavaScript 引 苟 以 外 , 还 使 用 了 高 效 的 libev 和 libeio 库 文 持 事件 继 动 和 异步 式 IO。 
图 1-2 是 Node.js 架构 的 示意 图 。 

Node.js 的 开发 者 在 libev 和 libeio 的 基础 上 还 抽象 出 了 层 libuv。 对 于 POSIX" 操 作 系统 ， 
libuv 通过 封装 libev 和 libeio 来 利用 epoll 或 kqueue。 而 在 Windows F, libuv {EH Y Windows 





(D POSIX ( Portable Operating System Interface ) 是 一 套 操作 系统 API 规范 。 一 般 而 言 ， 遵 守 POSIX 规范 的 操作 系统 
指 的 是 UNIX、Linux、Mac OS X 等 。 
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HJ IOCP ( Input/Output Completion Port， 输 入 输出 完成 山口 ) 机 制 ， 以 在 不 同 平台 下 实现 同 
样 的 高 性 能 。 






JavaScript Node 标 准 库 


Node 下 层 接 口 





Libuv 


B 


[1-2 Node.js 的 架 





1.4.2 Node.js E PHP + Nginx 


Snoopyxd 详细 对 比 了 Node.js 与 PHP+Nginx 组 合 ， 绪 果 显 示 在 3000 并 发 连接 、30 秒 的 
测试 下 ， 输 出 “hello world" iik: 

a PHP 每 秒 啊 应 请 求 数 为 3624， 平 均 每 个 请 求 啊 应 时 间 为 0.39 秒 ; 

Q Node.js 每 秒 啊 应 请 求 数 为 7677， 平 均 每 个 请 求 啊 应 时 间 为 0.13 秒 。 

而 同样 的 测试 ， 对 MySQL 查 询 操 作 : 

a PHP 每 秒 啊 应 请 求 数 为 1293 ， 平 均 每 个 请 求 啊 应 时 间 为 0.82 秒 ; 

O Node.js 每 秒 响应 请 求 数 为 2999， 平 均 每 个 请 求 响 应 时 间 为 0.33 秒 。 

关于 Node.js 的 性 能 优化 及 生产 部 署 ， 我 们 会 在 第 6 章 详 细 讨 论 。 











1.5 JavaScript 简 史 


EN Node.js 的 基础 ,JavaScript 是 一 个 完全 为 网 络 而 诞生 的 语言 。 在 今天 看 来 ,JavaScript 
具有 其 他 诸多 语言 不 具备 的 优势 ， 例 如 速度 快 、 开 销 小 、 容 易学 习 等 , 但 在 一 开始 它 却 并 不 
是 这 样 。 多 年 以 来 ，JavaScript 因为 其 低 效 和 兼容 性 差 而 广 受 诉 病 ， 一 直 是 一 个 被 人 嘲笑 的 
“丑小鸭 ”， 它 在 成 就 之 前 经 历 了 无 数 困难 和 坎坷 ,个 中 究竟 ,还 要 从 它 的 媳 生 讲 起 。 
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1.5.1 Netscape 5 LiveScript 


JavaScript 首次 出 现在 199$ 年 ， 正 如 现在 的 Node.js 一 样 ， 当 年 JavaScript 的 诞生 决 不 是 
偶然 的 。 在 1992 年 ， 一 个 叫 Nombas HZ H]JFZ f. "CHA (C minus minus, Cmm) ER, 
后 来 改名 为 ScriptEases ScriptEase 最 初 的 设计 是 将 一 种 微型 脚本 语言 与 一 个 叫做 Espresso Page 
的 工具 配合 ， 使 脚本 能 够 在 浏览 融 中 和 运行， 因此 ScriptEase 成 为 了 第 一 个 客户 端 脚本 语言 。 

网 景 公 司 也 想 独立 开发 一 种 与 ScriptEase 相似 的 客户 端 脚本 语言 ，Brendan Eich 接受 了 
这 一 任务 。 起 初 这 个 语言 的 目标 是 为 非 专业 的 开发 人 员 ( 如 网 站 设计 者 )， 提 供 一 个 方便 的 
工具 。 大 多 数 网 站 设计 者 没有 任何 编程 背景 ， 因 此 这 个 声言 应 该 尽 可 能 简单 、 易 学 ， 最 终 一 
个 弱 类 型 的 动态 解释 语言 LiveWire 加 此 诞生 。LiveWire 没 过 多 久 就 改名 为 LiveScript J, H 
到 现在 ， 在 一 些 古 老 的 Web 页 面 中 还 能 看 到 这 个 名 字 。 














1.5.2 Java 与 Javascript 


在 JavaScript 诞生 之 前 ，Java applet 曾经 被 热 炒 。 之 前 Sun 公司 一 直 在 不 遗 余力 地 推广 
Java， 宣 称 Java applet 将 会 改变 人 们 浏览 网 页 的 方式 。 然 而 市 场 并 没有 像 Sun 公司 预期 的 那 
样 好 ， 这 很 大 程度 上 是 因为 Java applet 速度 慢 而 且 操 作 不 便 。 网 景 公 司 的 市 场 部 门 抓 住 了 这 
个 机 遇 ， 与 Sun 合作 完成 了 LiveScript 实现 ， 并 在 网 景 的 Navigator 2.0 发 布 前 ， 将 LiveScript 
更 名 为 JavaScript。 网 景 公司 为 了 取得 Sun 公司 的 支持 , 把 JavaScript 称 为 Javaapplet 和 HTML 
的 补充 工具 ， 目 的 之 一 就 是 为 了 帮助 开发 者 更 好 地 操纵 Java applet. 

Netscape 决 不 会 预料 到 当年 那个 市 场 策 略 带 来 的 副作用 有 多 大 。 多 年 来 ， 到 处 都 有 人 混 
16$ Java 和 JavaScript 这 两 个 不 相干 的 语言 。 两 者 除了 和 名字 相似 和 历史 渊源 之 外 ， 几 乎 没有 任 
何 关 系 。 现 在 看 来 ， 从 论坛 到 邮件 列表 ， 从 网 站 到 图 书馆 ， 能 把 Java 和 JavaScript 区 分 开 的 
倒是 少数 ”。 图 1-3 是 百度 知道 上 的 “Java 相关 ”分 类 。 

















B JAVA 相关 

" Javascript (2770) " Hibernate (2752) - Struts (3190) " Servlet (2599) 
- J2EE (1569) - JavaBean (480) - Spring (2295) - JDBC (924) 

- Ajax (872) - J2ME (1600) - EJB (306) 


图 1-3 ”百度 知道 上 的 “Java 相关 ”分 类 








(D Brendan Eich 被 人 称 为 JavaScript 之 父 ， 他 完全 没 想到 上 自己 当年 无 心 设计 的 一 个 语言 会 成 为 今天 最 流行 的 网 络 脚 
本 语言 。 

© applet 的 意思 是 “小 程序 ”， 它 是 Java 的 一 个 客户 端 组 件 ， 需 要 在 “容器 ”中 运行 ， 通常 浏 览 絮 会 充当 这 个 容器 。 

(3) Brendan Eich 为 此 抱 憾 不 已 ， 他 后 来 在 一 个 名 为 “ JavaScript at Ten Years”( JavaScript 这 10 年 ) 的 演讲 稿 中 写 道 : 
“ Don't let marketing name your language." ( 不 要 为 了 营销 决定 语言 名 称 )。 
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1.5.3 ”微软 的 加 入 一 一 JScript 


就 在 网 景 公 司 如 日 中 天 之 时 ， 微 软 的 Internet Explorer 3 B Windows 95 OSR2 捆绑 销售 
的 策略 堪 称 一 颗 重 磅 炸弹 ,轻松 击败 了 强劲 的 对 手 一 一 网 景 公 司 的 Navigator。 尽 管 这 个 做 法 
致使 微软 后 来 声名 狼藉 ( 以 及 一 系列 的 反 垄 断 诉 讼 )， 但 Internet Explorer3 的 成 功 却 有 目 共 
睹 ， 其 成 功 不 仅仅 在 于 市 场 彰 销 策略 ， 也 源 于 产品 本 喘 。Internet Explorer 3 是 一 个 划时代 产 
品 ， 因 为 它 也 实现 了 类 似 于 JavaScript 的 客户 只 语言 一 一 JScript， 除 此 之 外 还 有 微软 的 “ 老 
本 行 ”VBScript。JScript 的 诞生 成 为 JavaScript 发 展 的 一 个 重要 里 程 碑 ， 标 志 了 动态 网 页 时 
代 的 全 面 到 来 。 图 1-4 是 Windows 95 上 的 Internet Explorer 3. 





E Your Internet Start Page - Microsoft Internet Explorer 
Fie Edit View Go Favorites Help 


c ^ 0 [) A (à Gr 


Back Foward Stop Refresh Home Search Favorites 








Welcome to, Explorer 


September 12, 1996 
CarPoint has the new 1997 models. Click the MSN tab to find out how they rate. 






If youve previously created a custom start page, you'll find it at MSN.com. To change the look of this page, 
click the Internet Explorer logo in the top-left corner until you find the theme you like best. 








A To view exciting multimedia content on the Web, click the View menu, click Options, and 
$ D ) Tip of the Day then click the Security tab. 






orm Free to Internet Explorer 3.0 users! Get a free subscription to the Wall Street Journal Interactive Edition 
and exciting offers from ESPNET SportsZone, MTY Online, Hollywood Online, and others! 





Learn About Itl 






Take a Test Ride on the Normandy Chat Server! You won't want to miss a live chat with Anthony Bay, 
General Manager of Microsoft's Normandy development team. He'll answer your questions about the latest 
developments in Normandy servers and how they can provide the foundation for dynamic, personalized 
Internet sites. Friday at 4:30 PST. 






If you have problems using our site or have general comments for us, we'd like to hear from you. 到 


网 1-4 Windows 95 上 的 Internet Explorer 3 


1.5.4 ”标准 化 一 一 ECMAScript 


最 初 JavaScript 并 没有 一 个 标准 ， 因 此 在 不 同 浏览 需 间 有 各 种 各 样 的 兼容 性 的 问题 。 
Internet Explorer 占领 市 场 以 后 这 个 问题 变 得 更 加 尖锐 ， 因 此 JavaScript 的 标准 化 势 在 必 行 。 
在 MIR coc 标准 由 诸多 软件 厂商 共同 提交 给 ECMA o a 
ECMA 通过 了 标准 ECMA-262, ， 也 就 是 ECMAScript。 紧 接着 国际 标准 化 组 织 也 采纳 了 
aui 标准 (ISO-16262). 在 接 下 来 的 几 年 里 , MAENAN 4874 ECMAScript 
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作为 规范 来 实现 JavaScript 解析 引擎 。 

ECMAScript 诞生 至 今 已 经 有 了 多 个 版 本 ， 最 新 的 版 本 是 在 2009 年 12 月 发 布 的 
ECMAScript 5， 而 到 2012 年 为 止 ， 业 界 普 这 支持 的 仍 是 ECMAScript 3， 只 有 新 版 的 Chrome 
和 Firefox KIN Y ECMAScript 5。 





ECMAScript 仅仅 是 一 个 标准 ,而 不 是 一 个 语言 的 具体 实现 , 而 且 这 个 标 
提示 准 不 像 C++ 语言 规范 那样 严格 而 详细 。 除 了 JavaScript Z2, ActionScript”, 
QtScript^, WMLScript^4^;€ ECMAScript 的 实现 。 





1.5.5 浏览 器 兼容 性 问题 


尽管 有 ECMAScript 作为 JavaScript 的 语法 和 语言 特性 标准 , 但 是 关于 JavaScript 其 他 方 
面 的 规范 还 是 不 明确 ， 同 时 不 同 浏 览 融 又 加 入 了 各 目 特有 的 对 象 、 函 数 。 这 也 驶 是 为 什么 这 
么 多 年 来 同样 的 JavaScript 代码 会 在 不 同 的 浏览 融 中 呈现 出 不 同 的 效果 ， 甚 至 在 一 个 浏 览 套 
中 可 以 执行 ， 而 在 另 一 个 浏览 需 中 却 不 可 以 。 

要 注意 的 是 ， 浏 览 硕 的 鳞 容 性 问题 并 不 只 是 由 JavaScript 的 兼容 性 造成 的 ， 而 是 DOM, 
BOM, CSS 解析 等 不 同 的 行为 导致 的 。 万 维 网 联盟 〈 World Wide Web Consortium, W3C ) 
针对 这 个 问题 提出 了 很 多 标准 建议 , 目前 已 经 几乎 被 所 有 厂商 和 社区 接受 , DU Vas TJA ETE 
问题 迅速 得 到 了 改善 。 











1.5.6 引擎 效率 革命 和 JavaScript 的 未 来 


第 一 款 JavaScript 引擎 是 由 Brendan Eich 在 网 景 的 Navigator 中 开发 的 ， 它 的 名 字 叫 做 
SpiderMonkey。 SpiderMonkey 在 这 之 后 还 用 作 Mozilla Firefox 1.0~3.0 厂 本 的 引擎 ， 而 从 
Firefox 3.5 FRN TraceMonkey，4.0 版 本 以 后 又 换 为 JaegerMonkey。Google Chrome 的 
JavaScript 引擎 是 V8， 同 时 V8 也 是 Node.js 的 引擎 。 微 软 从 Internet Explorer 9 开始 使 用 其 
新 的 JavaScript 引擎 Chakra, ^ 

HX, JavaScript 一 直 不 被 人 重视 ， 很 大 程度 上 是 因为 它 效 率 不 高 不 仅 速 度 慢 ， 还 
占用 大 量 内 存 。 但 如 今 JavaScript 的 效率 却 令 人 刮目相看 。 历 史 总 是 如 此 相似 ， 正 如 没有 
Shockley 发 明 品 体 管 就 没有 电子 科技 章 命 一 样 , 如 果 没 有 2008 年 以 来 的 JavaScript 引擎 革命 ， 
Node.js 也 不 会 这 么 快 诞 生 。 














(D ActionScript 最 初 是 Adobe 公司 Flash 的 一 部 分 , 用 于 控制 动画 效果 , 现在 已 经 被 广泛 应 用 在 Adobe 的 各 项 产品 中 。 
@) QtScript 是 Qt 4.3.0 以 后 引入 的 专用 脚本 工具 。 

(3 WMLScript 是 WAP 协议 的 一 部 分 ， 用 于 扩展 WML (Wireless Markup Language ) 页 面 。 

D 除 此 以 外 还 有 KJS ( 用 于 Konqueror )、Nitro (用 于 Safari )、Carakan ( 用 于 Opera ) 等 JavaScript 引擎 。 
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2008 年 Mozilla Firefox 的 一 次 改动 , 使 Firefox 3.0 的 JavaScript 性 能 大 幅 提 升 ， 从 而 引发 
了 JavaScript 引擎 之 间 的 效率 竞赛 。 紧 接着 WebKit" 开 发 团队 宣告 了 Safari 4 新 的 JavaScript 
引擎 SquirrelFish〈 后 来 改名 Nitro ) 可 以 大 幅度 提升 脚本 执行 速度 。Google Chrome 刚刚 诞 
生 就 因 它 的 JavaScript 性 能 而 备 受 称赞 ， 但 随 着 WebKit HJ Squirrelfish Extreme 和 Mozilla 的 
TraceMonkey 技术 的 出 现 ，Chrome 的 JavaScript 引擎 速度 被 超越 了 ， 于 是 Chrome 2 发 布 时 
使 用 了 更 快速 的 V8 引擎 。V8 一 出 场 就 以 其 一 骑 绝 侍 般 的 速度 打败 了 所 有 对 手 ， 一 度 成 为 
JavaScript 引 警 的 速度 之 王 。 于 是 其 他 浏览 硕 的 开发 者 开始 和 理 力 追赶 ， 与 以 往 不 同 的 是 ， 
Internet Explorer 也 加 入 了 这 次 鞠 宪 ,并 取得 了 不 俗 的 成 绩 。 

时 至 今日 ， 各 个 JavaScript 引擎 的 效率 已 经 不 相 上 下 ， 通 过 不 同 引擎 根据 不 同 测试 基 准 
测 得 的 结果 各 有 千秋 。 更 有 趣 的 是 ，JavaScript 的 效率 在 不 知 不 党 中 已 经 超越 了 其 他 所 有 传 
统 的 脚本 语言 ， 并 市 动 了 解释 各 的 单 新 运动 。JavaScript 已 经 成 为 了 当今 速度 最 快 的 脚本 声 
AL, EA "HB" AFI TRER ARR” . 

尽管 如 此 ， 我 们 不 能 否认 JavaScript 还 有 很 多 不 完美 之 处 ， 壁 如 一 些 违反 直觉 的 特性 ， 
这 几乎 成 了 JavaScript 遭受 批评 和 攻击 的 焦点 。 如 今 JavaScript 还 在 继续 发 展 , ECMAScript 6 
也 正在 起 草 中 ， 更 有 像 CoffeeScript 这 样 专门 为 了 弥补 JavaScript 语言 特性 的 不 足 而 诞生 的 
语言 。Google 也 专门 针对 客户 端 JavaScript 不 完美 的 地 方 推 出 了 Dart 语言 。 随 着 大 规模 的 应 
用 推广 ， 我 们 有 理由 相信 JavaScript 会 变 得 越 来 越 好 。 


























1.6 CommonJS 


1.6.1 服务 端 JavaScript 的 重生 


Node.js 并 不 是 第 一 个 尝试 使 JavaScript 运行 在 浏览 紫 之 外 的 项 目 。 追 根 济源 ， 在 
JavaScript 放生 之 初 ， 网 景 公司 就 实现 了 服务 端的 JavaScript， 但 由 于 需要 文 付 一 大 笔 授 权 费 
用 才能 使 用 ， 服 务 端 JavaScript 在 当年 并 没有 像 客 户 问 JavaScript 一 样 流 行 开 来 。 真 正 使 大 
多 数 人 见识 到 JavaScript 在 服务 硕 开 发 威力 的 ， 是 微软 的 ASP。 

2000 年 左右 , EDE ASP RH EWER, 很 多 开发 者 开始 学 习 JScript。 然而 JScript 在 
当时 并 不 是 很 受 欢 迎 ， 一 方面 是 早期 的 JScript 和 JavaScript 兼 容 较 差 ， 另 一 方面 微软 大 力 推 
广 的 是 VBScript， 而 不 是 JScript。 随 着 后 来 LAMP 的 兴起 ， 以 及 Web 2.0 时 代 的 到 来 ，Ajax 
等 一 系列 概念 的 提出 ，JavaScript 成 了 前 端 开发 的 代名词 ,同时 服务 并 JavaScript 也 逐渐 被 人 


ud 
utis 

















(D WebKit 是 苹果 公司 在 设计 Safari 时 开发 的 浏览 右 引 擎 ， 起 源 于 KHTML 和 KIS 项 目的 分 文 。WebKit 包含 了 一 个 
网 页 引擎 WebCore 和 一 个 脚本 引擎 JavaScriptCore ， 但 由 于 JavaScript 引擎 越 来 越 独 立 ，WebKit 逐渐 成 为 了 
WebCore 的 代名词 。 
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直至 几 年 前 ，JavaScript 的 种 种 优势 才 被 重新 提起 ，JavaScript 又 具备 了 在 服务 端 流行 的 
条 件 , Node.js 应 运 而 生 。 与 此 同时 , RingoJS 也 基于 Rhino 实现 了 类 似 的 服务 端 JavaScript 平 
台 ， 还 有 像 CouchDB MongoDB 等 新 型 非 关 系 型 数据 库 也 开始 用 JavaScript 和 JSON 作为 
其 数据 操纵 语言 ， 基 于 JavaScript 的 服务 端 实 现 开 始 志 地 开花 。 


1.6.2 CommonJS 规范 与 实现 


正如 当年 为 了 统一 JavaScript 语言 标准 ， 人 们 制定 了 ECMAScript 规范 一 样 ， 如 今 为 了 
统一 JavaScript 在 浏览 希 之 外 的 实现 ，CommonJS 诞生 了 。CommonJSs 试图 定义 一 套 普 通 应 
用 程序 使 用 的 API， 从 而 填补 JavaScript 标准 库 过 于 简单 的 不 足 。CommonJS 的 终极 目标 是 
制定 一 个 像 C++ 标准 库 一 样 的 规范 ， 使 得 基于 CommonJS API 的 应 用 程序 可 以 在 不 同 的 环 
境 下 运行 ， 就 像 用 C++ 编写 的 应 用 程序 可 以 使 用 不 同 的 编译 句 和 运行 时 因数 库 一 样 。 为 了 
保持 中 立 ，CommonJS 不 参与 标准 库 实现 ， 其 实现 交 给 像 Node.js 之 类 的 项 目 来 完成 。 图 1-5 
是 CommonJS 的 各 种 实现 。 














CommonJS 
nedeo 


ringo 
C PERSEVERE 


J mongoDb 
CouchDB 


relax 





[&|1-5 | CommonJS 的 实现 


CommonJS 规范 包括 了 模块 (modules )、 包 ( packages )、 系统 ( system )、 Zitti] ( binary )、 
控制 台 (console), 25fj (encodings )、 文 件 系统 (filesystems )、 套 接 字 (sockets )、 单 元 测 
iX (unit testing ) 等 部 分 。 目 前 大 部 分 标准 都 在 拟定 和 讨论 之 中 ,已 经 发 布 的 标准 有 
Modules/1.0, Modules/1.1, Modules/1.1.1, Packages/1.0, System/1.0, 
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Node.js 是 目前 CommonJS 规范 最 热门 的 一 个 实现 , 它 基 于 CommonJS 的 Modules/1.0 规 
范 实 现 了 Node.js 的 模块 ， 同 时 随 着 CommonJS 规范 的 更 新 ，Node.js 也 在 不 断 跟 进 。 由 于 目 
前 CommonJS 大 部 分 规范 还 在 起 草 阶段 ，Node.js 已 经 率先 实现 了 一 些 功能 ， 并 将 其 反馈 给 
CommonJS 规范 制定 组 织 ， 但 Node.js 并 不 完全 遵循 CommonJS 规范 。 这 是 所 有 规范 制定 者 
都 会 遇 到 的 廿 众 局 面 ， 因 为 规范 的 制定 总 是 小 后 于 技术 的 发 展 。 


1.7 














CQ Node.js: http://node]s.org/; 


E 


" 


E 


L 


“再 谈 select、iocp、epoll、kqueue 及 各 种 VO 复 用 机 制 ”*: http://blog.csdn.net/shallwake/ 
article/details/5265287 , 
“ 匡 峰 对 决 ， node.js 和 php 性 能 测试 ”: http://snoopyxdy.blog.163.com/blog/static/6011744 
0201183101319257/。 
"RingoJS vs. Node.js: Runtime Values": http://hns.github.com/2010/09/21/benchmark. html; 
"Update on my Node.js Memory and GC Benchmark": http://hns.github.com/2010/ 09/29/ 
benchmark2.html., 
“JavaScript at Ten Years": http://dl.acm.org/citation.cfm?1d-1086382 , 
QtScript: http://qt-project.org/doc/qt-A.8/qtscript.html - 
WebKit Open Source Project : http://www.webkit.org/. 
CommonJS API Specifications : http://www.commonjs.org/specs/. 
RingoJS : http://ringojs.org/; 
MongoDB : http://www.mongodb.org/, 
CouchDB : http://couchdb.apache.org/, 
Persevere : http://www.persvr.org/; 
(JavaScript 语言 精髓 与 编程 实践 》 周 爱民 著 ， 电 子 工 业 出 版 社 出 版 。 
(JavaScript 高 级 程序 设计 (第 3 版 )》Nicholas C. Zakas 着， 人 民 邮 电 出 版 社 出 版 。 
(JavaScript 权威 指南 ( 第 5 版 )》Flanagan David 著 ， 机 械 工 业 出 版 社 出 版 。 
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在 使 用 Nodes 开发 之 前 ， 我 们 首先 要 配置 好 开发 环境 。 本 和 曹 的 主要 内 容 有 : 
口 如 何在 Linux, Windows, Mac OS X 上 通过 包 或 包 管理 器 安装 Node.js ; 
a 如 何在 POSIX 和 Windows 下 通过 编译 源 代码 安 疙 Node.js ; 

口 安装 npm (Node.js 4 bg ); 

D 使 用 多 版 本 管理 硕 让 多 个 Node.js 的 实例 共存 。 


2.1 ”安装 前 的 准备 


Node.js 的 生态 系统 建立 在 遵循 POSIX 标准 的 操作 系统 上 ， 如 GNU/Linux, Mac OS X, 
Solaris 等 。Node.js 起 初 不 文 持 Windows， 只 能 运行 在 cygwin 上 ， 而 0.6 厂 本 以 后 就 文 持 
Windows 了 ， 本 节 后 面 会 详 述 。 

从 2009 年 诞生 至今，Node.js 一 直 处 在 快速 发 展 的 时 期 ， 因 此 很 多 方法 、 技 巧 都 会 迅速 
被 新 的 技术 取代 ， 本 书 内 容 也 不 例外 。 就 在 不 久 前 ， 大 家 还 都 推荐 通过 编译 源 代 码 安装 
Node.js， 而 现在 已 经 有 了 成 熟 的 安装 包 发 行 系统 。 我 们 推荐 你 尽量 通过 Node.js 官方 或 操作 
系统 发 行 版 提供 的 途径 进行 安装 ， 除 非 你 想 获 得 最 新 的 版 本 ,否则 就 不 要 费力 编译 T。 











Windows 上 的 Node.js 


Node.js 从 0.6 版 本 开始 可 以 运行 在 原生 的 Windows 上 了 (不 是 cygwin 或 者 其 他 虚拟 环 
境 )。 这 很 大 程度 上 应 该 归功 于 微软 的 合作 ， 为 微软 的 云 计算 平台 Windows Azure 宣布 了 
对 Node.js 完全 支持 。 这 对 微软 来 说 简直 是 破天荒 的 举动 ， 因 为 一 贯 具有 “开源 死敌 ”之 称 
的 微软 ， 竞 然 支 持 具有 深厚 开源 血统 的 Node.js， 不 得 不 令 人 上 蜂 目 结 

KE, Node.js 与 Windows 的 莱 容 性 仍然 不 如 POSIX 操作 系统 ， 这 一 点 在 npm fè 
供 的 第 三 方 模块 中 体现 得 尤为 突出 。 这 主要 是 因为 许多 第 三 方 的 模块 需要 编译 原生 的 C/C++ 
代码 ， 其 中 编译 框架 和 系统 调用 很 多 都 是 以 Linux 为 范本 的 ,与 Windows 不 兼容 。 笔 者 不 建 
以 在 Windows 上 进行 Node.js 开发 或 部 团 ， 当 然 出 于 学 习 目 的 ， 这 些 影 响 也 是 无 关 紧 要 的 。 
相信 随 着 Node.js 的 发 展 ( 以 及 微软 与 开源 社区 关系 的 进一步 改善 )，Node.js 与 Windows 的 
兼容 性 会 越 来 越 好 。 

接 下 来 的 小 节 我 们 将 详细 介绍 Node.js 的 安装 方法 。 
































2.2 Rx 
2.2.1 Microsoft Windows 系 统 上 安装 Node.js 


在 Windows 上 安装 Node.js 十 分 方便 ， 你 只 需要 访问 http:/nodejs.orfg， 点 击 Download 链 
接 ， 然 后 选择 Windows Installer， 下 载 安 疙 包 。 下 载 完 成 后 打开 安装 包 ( 如 图 2-1 所 示 ), 点击 
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Next 即 可 H HÉR 





- 
J5 node.js Setup 


Welcome to the node.js Setup Wizard 





The Setup Wizard will install node.js on your computer. Click 
Next to continue or Cancel to exit the Setup Wizard. 








图 2-1 在 Windows 上 安装 Node.js 





安装 程序 不 会 询问 你 安装 路 径 ，Node.js 会 被 自动 安装 到 C:\Program Filesnodejs 或 
C:\Program Files (x86)\nodejs ( 64 位 系统 ) 目录 下 ， 并 日 会 在 系统 的 PATH 环境 变量 中 增加 该 
HX, Sr ow 的 命令 提示 符 中 和 下 接 运 行 node. 

为 了 测试 是 否 已 装 成 功 , 我 们 在 运行 中 输入 cmd, 打开 命令 提示 符 , 然后 输入 node, 
将 会 进入 Node.js E 如 图 2-2 所 示 。 











= 
EN Administrator: C\windows\system32\cmd.exe - cmd - cmd 


(^C again to quit) 


C:\Users\byvoid> 











图 2-2 Windows 命令 提示 符 下 的 Node.js 





通过 这 种 方式 安装 的 Node.js 还 目 动 附带 了 npm 图 2-2， 我 们 可 以 在 命令 提示 符 中 直接 
输入 npm 来 使 用 它 。 
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2.2.2. Linux 发 行 版 上 安装 Node.js 

Node.js 目前 还 处 在 快速 变化 的 时 期 ， 它 的 发 行 速度 要 远 远 大 于 Linux 发 行 版 维护 的 周 
期 ， 因 此 各 个 Linux 发 行 厂 官方 的 软件 包 管 理 硕 中 提供 的 Node.js 往往 都 比较 过 时 。 尽 管 如 
此 , 我 们 还 是 可 以 通过 发 行 版 的 包 管 理 需 获得 一 个 较为 稳定 的 版 本 ， 根 据 不 同 的 发 行 版 , 通 
过 以 下 命令 来 获取 Node.js， 人 参见 表 2-1。 


表 2-1 在 Linux 发 行 版 中 获取 Node.js 


Linux 发 行 版 命令 
Debian/Ubuntu apt-get install nodejs 
Fedora/RHEL/CentOS/Scientific Linux yum install nodejs 
openSUSE Zypper install nodejs 
Arch Linux pacman -S nodejs 














AIR 22 RFA E BE OR XISHBOBT UB Nodejs， 就 要 根据 不 同 的 发 行 版 选择 第 
三 方 的 软件 源 , 具体 请 参阅 : https://github.com/joyent/node/wiki/Installing-Node.js-via-package- 


managers 





2.2.3 Mac OS X E Z Node js 


Node.js 官方 专门 提供 了 Mac OS X 的 安装 包 ， 你 可 以 在 http://nodejs.org 1X Download 
链接 ， 然 后 选择 Macintosh Installer, PRERE. PRESITE, (如 图 2-3 所 示 ), 
根据 提示 完成 安 猴 。 








9 安装 "Node 
坎 迎 使 用 "Node" 安 装 程式 


This package will install node and npm into /usr/local/bin 





图 2-3 Æ Mac OS X 上 安装 Node.js 








Node.js 和 npm 会 被 安装 到 /usr/local/bin 目录 下 ， 安 痛 过 程 中 需要 系统 管理 员 权 限 。 安 
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装 成 功 后 你 可 以 在 终端 机 中 运行 node 命令 进入 了 Nodejs 的 交互 模式 。 如 果 出 现 -bash: 
node: command not found， 说 明 没 有 正确 安装 ， 需 要 重新 运行 安装 包 或 者 来 取 其 他 形式 
安装 Node.js- 








2.3 ”编译 源 代码 


Node.js 从 0.6 版 本 开始 已 经 实现 了 源 代 人 码 级 别 的 里 平 台 , 因此 我 们 可 以 使 用 不 同 的 编译 
命令 将 同一 份 源 代码 的 基础 上 编译 为 不 同 平 台 下 的 原生 可 执行 代码 。 

在 编译 之 前 ， 要 先 获取 源码 包 。 我 们 建议 访问 http:/nodejs.org， 点 击 Download 链 接 ， 然 
后 选择 Source Code, 下载 正 式 发 布 的 源码 包 。 如 果 你 需要 开发 中 的 版 本 ， 可 以 通过 
https://github.com/joyent/node/zipball/master 获得 ， 或 者 在 命令 行 下 输入 git clone git: 
I7Zgicthub.com/Jjoyent/node.gat 从 git 获 得 最 新 的 分 支 。 








2.3.1 Æ POSIX 系统 中 编译 








在 POSIX 系统 中 编译 Node.js 需要 三 个 工具 : 

OQ C++ 编译 各 gcc 或 clang/LLVM ; 

O Python 版 本 2.5 以 上 ， 不 支持 Python 3; 

口 libssl-dev 提供 SSL/TLS 加 密 支 持 。 

如 果 你 使 用 Linux， 那 么 你 需要 使 用 g++ 来 编译 Node.js。 在 Debian/Ubuntu 中 ， 你 可 以 
通过 apt-get install g++ 命令 安装 g++。 在 Fedora/Redhat/CentOS 中 ， 你 可 以 使 用 yum 
install gcc-c++ 安装 。 

如 果 使 用 的 是 MacOSX, 那么 需要 安装 Xcode。 默认 情况 下 , 系统 安装 盘 中 会 有 Xcode, 
可 以 从 光 检 中 安装 ， 或 者 访问 https://developer.apple.com/xcode/ 下载 最 新 的 版 本 。 

Mac OS X 和 几乎 所 有 的 Linux 发 行 版 都 内 置 了 Python， 你 可 以 在 终端 机 输入 命令 
python --version 检查 Python 的 版 本 ， 可 能 会 显示 PYCHON se 或 其 他 版 本 。 如 果 你 
发 现 版 本 号 小 于 2.$ 或 者 直接 出 现 了 command not _ found， 那么 你 需要 通过 软件 包 管 理 需 
获得 一 个 新 版 本 的 Python， 或 者 到 http://python.org/ 下 载 一 个 。 

libssl-dev 是 调用 OpenSSL 编译 所 需 的 头 文件 ,用 于 提供 SSL/TLS 加 密 文 择 。Mac OS 
X 的 Xcode 内 置 了 libssl-dev, TE Debian/Ubuntu 中 ， 你 可 以 通过 apt-get install 
libssl-dev 命令 安装 。 在 Fedora/Redhat/CentOS 中 ， 你 可 以 通过 yum install 
openssl-devel 命令 安装 。 同 样 ， 你 也 可 以 访问 http:/openssl.org/ 下 载 一 个 。 

接 下 来 ， 进 入 Node.js 源 代 码 所 在 目录 ， 运 行 : 


./configure 

















make 
sudo make install 
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之 后 大 约 等 待 20 分 钟 ，Node.js 就 安装 完成 了 ， 而 且 附 市 安装 了 npm., 
如 果 你 使 用 Mac OS X, 还 可 以 尝试 使 用 homebrew 编译 安装 Node.js。 首先 在 http://mxcl. 
github.com/homebrew/3XJBt homebrew, 人 然后 通过 以 下 命令 即 可 自动 解析 编译 依赖 并 安装 Node.js: 


brew install node 


2.3.2 在 Windows 系 统 中 编译 





Node.js 在 Windows 下 只 能 通过 Microsoft Visual Studio 编译 ,因此 你 需要 首先 安装 Visual 
Studio 或 者 免费 的 Visual Studio Express。 你 还 需要 安装 Python 2 (2.5 以 上 的 版 本 ,但 要 小 于 
3.0 )， 可 以 在 http://python.org/ 了 取得。 安装 完 Python 以 后 请 确保 在 PATH 环境 变量 中 添加 
python.exe 所 在 的 目录 ， 如 采 没 有 则 需要 手动 在 “系统 属性 ”中 添加 。 

一 切 准 备 好 以 后 ， 打 开 命令 提示 符 ， 进 入 Node.js 源 代码 所 在 的 目录 进行 编译 : 























C:NUsersNbyvoidNnode-v0.6.12»vcbuild.bat release 

['-f', 'msvs', '-G', 'msvs version-z2010', '.XMnode.gyp', '-I', '.NNXcommon.gypi', '--depthz.', 
'-Dtarget Project files generated. 

C:\Program Files (x86) MMSBuildMMicrosoft.CppNv4.0MMicrosoft.CppBuild.targets(1151,5): 
warning MSB8012: http parser.vcxproj -> C:WNUsersNMbyvoidNnode-v0.6.12^ 





ReleaseNMhttp parser.lib 


js2c, and also js2c experimental 





node js2c 


大 约 等 竺 20 分 钟 ， 编 译 完 成 。 在 Release 子 目录 下 面 会 有 一 个 node.exe 文件 ， 这 就 是 我 
们 编译 的 唯一 目标 ,也 许 有 些 令 人 惊讶 ,Node.js 编译 后 只 有 一 个 node.exe 文 件 ,这 说 明 Node.js 
的 核心 非常 小 巧 精 悍 。 直 接 运 行 node.exe 即 可 进入 Node.js 的 交互 模式 ， 在 系统 PATH 环境 
变量 中 添加 node.exe 文 件 所 在 的 目录 ， 这 样 就 可 以 在 命令 行 中 运行 node MET, HFT 
作 就 是 手动 安装 npm To 











2.4 ”安装 Node 包 管 理 器 


Node 包 管 理 需 (npm ) 是 一 个 由 Node.js 官方 提供 的 第 三 方 包 管理 工具 ， 就 像 PHP 的 
Pear, Python 的 PyPI 一 样 。npm 是 一 个 完全 由 JavaScript 实现 的 命令 行 工具 , 通过 Node.js H 
行 ， 因 此 严格 来 讲 它 不 属于 Nodejs 的 一 部 分 。 在 最 初 的 版 本 中 ,我们 需要 在 安装 完 Node.js 
以 后 手动 安装 npm。 但 从 Node.js 0.6 开始 ，npm 已 包含 在 发 行 包 中 了 ， 我们 在 Windows, 
Mac 上 安 狐 包 和 源 代 码 包 时 会 日 动 同时 安 污 npm。 

如 果 你 是 在 Windows 下 手动 编译 的 ， 或 是 在 POSIX 系统 中 编译 时 指定 了 --without-npm 
人 参数， 那 就 需要 手动 安装 npm 了 。http:/npmjs.org/ 提 供 了 npm 几 种 不 同 的 安装 方法 ， 通 党 























你 只 需要 执行 以 下 命令 : 
curl http://npmjs.org/install.sh | sh 
TR KRIER BR BU TRIRSR , ISI TE root DU. PET. E REIR) ,或 者 使 用 suao。 
curl http://npmjs.org/install.sh | sudo sh 


其 他 安装 方法 ， 壁 如 从 git 中 获取 npm 的 最 新 分 文 ， 可 以 参考 http//npmjs.org/doc/ 
README.html 上 的 说 明 。 





2.5 XR REI 


运 今 为 止 Node.js 更 新 速度 还 很 快 ， 有 时 候 新 版 本 还 会 将 旧版 本 的 一 些 API 废除 ， 以 至 
于 写 好 的 代码 不 能 回 下 兼容 。 有 时 候 你 可 能 想 要 尝试 一 下 新 版 本 有 趣 的 特性 , 但 又 想 要 保持 
一 个 相对 稳定 的 环境 。 基 于 这 种 需求 ，Node.js 的 社区 开发 了 多 版 本 管理 机 ， 用 于 在 一 合 机 
妖 上 维护 多 个 版 本 的 Nodejs 实例 ， 方便 按 需 切 换 。Node JU EES (Node Version 
Manager, nvm) 是 一 个 通用 的 叫 法 ， 它 目前 有 许多 不 同 的 实现 。 通 常 我 们 说 的 nvm 是 指 
https://github.com/creationix/nvm 或 者 https://github.conyvisionmedia/n。 笔 者 根据 个 人 偏好 推 
存 使 用 visionmedia/n， 此 小 市 就 以 它 为 例子 介绍 Node 多 版 本 管理 需 的 用 法 。 

n 是 一 个 十 分 人 简洁 的 Node 多 厂 本 管理 希 ， 就 连 它 的 名 字 也 不 例外 。 它 的 名 字 束 是 n, 
没 错 ， 就 一 个 字母 。” 

如 果 你 已 经 安装 好 了 Node.js 和 npm 环境 ， 就 可 以 直接 使 用 npm install -g n 命令 
来 安 猴 no 当然 你 可 能 会 问 : 如 果 我 想 完 全 通过 mn 来 管理 Node.js ,那么 没 安 妆 之 前 哪 来 的 npm 
呢 ? 事实 上 ，D 并 不 需要 Node.js 驱动 ， 它 只 是 bash 脚本， 使 用 npm 安装 只 是 采取 一 种 简便 
的 方式 而 已 。 我 们 可 以 在 https://github.conyvisionmedia/n 下 载 它 的 代码 ， 然 后 使 用 make 


install 命令 安装 。 


























pi n 不 支持 Windows. 
警告 





安装 完 n 以 后 ， 在 终端 中 运行 n --help 即 可 看 到 它 的 使 用 说 明 : 
$ n --help 


Usage: n [options] [COMMAND] [config] 


中 事实 上 , n 它 曾经 叫做 nvm， 后 来 改名 为 n。 
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Commands : 
n Output versions installed 
n latest [config ...] Install or activate the latest node release 
n «version» [config ...] Install and/or use node «version» 
n use «version» [args ...] Execute node «version» with [args ...] 
n bin «version» Output bin path for <version> 
n rm «version ...» Remove the given version(s) 
n --latest Output the latest node version available 
n ls Output the versions of node available 
Options: 
-V, --version Output current version of n 
-h, --help Display help information 
Aliases: 
- rm 
which bin 
use as 
list ls 


运行 n 版 本 号 可 以 安装 任意 已 发 布 版 本 的 Node.js,n 会 从 http://nodejs.org 下 载 源 代码 包 ， 
SAGESSE. PU: 


S n 0.7.5 


E E E E E E E EE SERERE REESE E EE RE RE E E RE EH Wu dgdidzuddidzriudsdduidss4s4ss 100.0% 
i 'targeLt deraults's i1 'ocrlaos's Ll], 














'defines': [l, 
'include dirs': [], 
'libraries': ['-1z']), 
"varriables': 1 'host _ arch': 'x64!, 
'node install npm': 'true', 
'node install waf': 'true', 
'Dhode prefix': '/usr/local/n/versions/0.7.5', 
'node shared cares': 'false', 
'node shared v8': 'false', 
'node use dtrace': 'false', 
'node use openssl': 'true', 
'node use system openssl': 'false', 
"Lerget arch': 'x64', 
'v8 use snapshot': 'true'}} 


creating  ./config.gypi 
creating  ./config.mk 
make -C out BUILDTYPE-Release 
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CC(target) /usr/local/n/node-v0.7.5/out/Release/obj.target/http parser/deps/ 
http parser/http parser.o 
LIBTOOL-STATIC /usr/local/n/node-v0.7.5/out/Release/libhttp parser.a 


通过 nn 获取 的 Node.js 实例 都 会 安装 在 /usr/local/n/versions/ 目录 中 。 


3l 


v. 





之 后 再 运行 n Bling e. ge UH Node.jjs， 其 中 “*” 后 的 版 本 号 为 默认 的 
Node.js 版 本 ， 即 可 以 直接 使 用 noae 命令 行 调用 的 版 本 : 
Sn 


0.6.11 
* dl. 


FIZZRGUU— TE, ÍT n AK tn] EEB CR Node.js 实例 中 切换 环境 ， 再 运行 
node 即 为 n 指定 的 当前 版 本 ,例如 : 


$ n 0.6.11 
* 0.6.11 
0:75 
S node -v 

v0.6.11 


如 果 你 不 想 切 换 默 认 环 境 ， 可 以 使 用 n use 版 本 号 script .js 直接 指定 Node.js 的 运 
行 实例 ， 例 如 





$n use 0.6.11 script.js 


"i n 无 法 管理 通过 其 他 方式 安装 的 Node.js 版 本 实例 (如 官方 提供 的 安装 
警告 包 、 发 行 版 软件 源 、 手 动 编译 )， 你 必须 通过 n 安装 Node.js 才能 管理 多 版 
本 的 Node.js. 











RF n 的 更 多 细节 ， 请 访问 它 的 项 目 主页 https:/github.comy/visionmediammn 获 取信 息 。 


26 ”参考 资料 


Q "Building and Installing Node.js”: https://github.com/joyent/node/wiki/Installation.; 
DQ “Node package manager": http://npmjs.org/doc/README:.html., 


DQ “Node version management": https://github.com/visionmedia/n; 
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"TRA H Node.js ( 二) : Node.js & NPM 的 安 闻 与 配置 http://www.infoq.com/cn/ 
articles/nodejs-npm-install-config ; 


“Node.js Now Runs Natively on Windows": http://www.infoq.com/news/2011/11/Nodejs- 
Windows; 


(Node Web 开 发 》》 David Herron, A FEHR HE HB CE HH C 
“如 何在 Mac OS X Lion 上 设 定 nodejs 的 开发 环境 ”: http://dreamerslab.com/blog/tw/ 


how-to-setup-a-node- js-development-environment-on-mac-osx-lion/。 
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Node.js 是 一 个 方兴未艾 的 技术 。 一 直 以 来 , 天 于 Node.js 的 宣传 往往 针对 它 “ 与 众 不 同 ” 
的 特性 ， 这 使 得 它 显 得 格外 扑朔迷离 。 事 实 上 ，Node.js 的 绝 大 部 分 特性 跟 大 多 数 语言 一 样 都 
是 旧 瓶 痛 新 酒 ， 只 是 一 些 激 进 的 特性 使 它 显 得 很 神秘 。 在 这 一 音 中 ， 我 们 将 会 讲述 Node.Jjs 的 
种 种 特性 , 让 你 对 Node.js 本 映 以 及 如 何 使 用 Node.js 编程 有 一 个 全 局 性 的 了 解 ， 主要 内 容 有 : 

口 编写 第 一 个 Node.js 程 序 ; 

a 异步 式 I1O 和 事件 循环 ; 

OQ 模块 和 包 

a 调试 。 

让 我 们 开始 这 个 激动 人 心 的 旅程 吧 。 


3.1 开始 用 Node.js 编程 


Node.js HA WERA MIR, 它 趾 生 于 托管 了 许多 优秀 开源 项 目的 网 站 一 一 github。 和 
大 多 数 开源 软件 一 样 ， 它 由 一 个 黑客 发 起 ,然后 吸引 T 了 一 小 拨 爱 好 者 参与 页 献 代 码 。 一 开始 
它 默 默 无 闻 ， 徘 口 口 相传 扩散 ， 和 直到 菏 一 大 被 一 个 于 客 巡 体 曝光 ,进入 业界 视野 ， 随 后 便 有 
一 些 有 远见 的 公司 提供 商业 文 持 ， 使 其 逐步 发 展 壮 大 。 

用 Node.js 编程 是 一 件 令 人 愉快 的 事情 ， 因 为 你 将 开始 用 黑客 的 思维 和 风格 编写 代码 。 
你 会 发 现 像 这 样 的 语言 是 很 容易 和 人 门 的 ， 可 以 快速 了 解 到 它 的 细节 ， 然 后 车 握 它 。 























3.1.1 Hello World 
好 了 了 ， 让 我 们 开始 实现 第 一 个 Node.js 程序 吧 。 打 开 你 常用 的 文本 编辑 需 ,， 在 其 中 输入 : 


console.log('Hello World'); 


将 文件 保存 为 helloworldjs， 打 开 终端 ， 进 入 helloworld.js 所 在 的 目录 ， 执 行 以 下 命令 : 





node helloworld.js 


如 果 一 切 正常 ， 你 将 会 在 终端 中 看 到 输出 Hello worla。 很 简单 吧 ? 下 面 让 我 们 来 解 
释 一 下 这 个 程序 的 细节 。console 是 Node.js 提供 的 控制 台 对 象 ， 其 中 包含 了 癌 标 准 输 出 写 
和 人 的 操作 ， 如 console.log, console.error 等 。 console.log 是 我 们 最 常用 的 输出 
指令 ， 它 和 C 语言 中 的 printf 的 功能 类 似 ， 也 可 以 接受 任意 多 个 参数 ， 支 持 sa 、ss 变 
量 引 用 ， 例 如 : 


//consolelog.js 





console.log('%s: %d', 'Hello', 25); 


输出 的 是 Hello: 25。 这 只 是 一 个 人 简单 的 例子 ,如果 你 想 了 解 console 对 象 的 详细 功能 ， 
请 参见 4.1.3 节 。 
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3.1.2. Node js 命令 行 工 具 


在 前 面 的 Hello World 示例 中 ， 我 们 用 到 了 命令 行 中 的 node 命令 , 输入 node --help 
可 以 看 到 详细 的 帮助 信息 : 


Usage: node [options] [ -e script | script.js ] [arguments] 
node debug script.js [arguments] 


Options: 
-v, --version print node's version 
-e, --eval script evaluate script 
-p, --print print result of --eval 
--v8-options print v8 command line options 
--varsg print various compiled-in variables 


--max-stack-size-val set max v8 stack size (bytes) 


Environment variables: 

NODE PATH ';'-separated list of directories 
prefixed to the module search path. 

NODE MODULE CONTEXTS Set to 1 to load modules in their own 
global contexts. 

NODE DISABLE COLORS Set to 1 to disable colors in the REPL 





Documentation can be found at http://nodejs.org/ 





其 中 显示 了 node 的 用 法 ,运行 Node.js 程序 的 基本 方法 就 是 执行 node script.js， 
其 中 script.7s" 是 脚本 的 文件 名 。 
除了 直接 运行 脚本 文件 外 ，node --help 显示 的 使 用 方法 中 说 明了 男 一 种 输出 Hello 
World 的 方式 : 





5 node -e "console.log('Hello World');" 
Hello World 


我 们 可 以 把 要 执行 的 语句 作为 node -e 的 参数 直接 执行 。 

使 用 node 的 REPL 模式 

REPL ( Read-eval-print loop )， 即 输入 一 求 值 一 输出 循环 。 如 果 你 用 过 Python， 就 会 知 
道 在 终端 下 运行 无 参数 的 py thon 命令 或 者 使 用 Python IDLE 打开 的 shell， 可 以 进入 一 个 即 
时 求 值 的 运行 环境 。Node.js 也 有 这 样 的 功能 ， 运 行 无 参数 的 node 将 会 局 动 一 个 JavaScript 
的 交互 式 shell: 











中 事实 上 脚本 文件 的 扩展 名 不 一 定 是 js， 例 如 我 们 将 脚本 保存 为 script.txt， 使 用 node script.txt 命令 同样 可 
以 运行 。 扩 展 名 使 用 .js 只 是 一 个 约定 而 已 ， 遵 循 了 JavaScript 脚本 一 贯 的 命名 习惯 。 
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$ node 

> console.logi'Hello world'); 

Hello World 

undefined 

> consol.log('Hello World')s 
ReferenceError: consol is not defined 





repl:1:1 

REPLServer.eval (repl.js:80:21) 
repl.js:190:20 

REPLServer.eval (repl.js:87:5) 


£v 


(et cr ct cf ctf vcf ctf ct 


Interface.«anonymous» (repl.js:182:12) 
Interface.emit (events.js:67:17) 
Interface. onLine (readline.js:162:10) 
Interface. line (readline.js:42606:8) 














Ctr 


Interface. ttyWrite (readline.js:003:14) 





o o ooo 9 9 Q Q 


t ReadStream.«anonymous» (readline.js:82:12) 


进入 REPL 模式 以 后 , 会 出 现 一 个 “>” 提 示人 符 提示 你 输入 命令 , 输入 后 按 回 和 车 ,Node.js 
将 会 解析 并 执行 命令 。 如 有 果 你 执行 了 一 个 函数 ， 那么 REPL 还 会 在 下 面 显示 这 个 函数 的 返回 
值 ， 上 面 例 子 中 的 undefined 就 是 console.log 的 返回 值 。 如 果 你 输入 了 一 个 错误 的 
指令 ，REPL 则 会 立即 显示 钳 误 并 输出 调用 栈 。 在 任何 时 候 ， 连 续 按 两 次 Ctrl + C 即 可 推出 
Node.js HJ REPL 模式 。 

node 提出 的 REPL 在 应 用 开发 时 会 给 人 市 来 很 大 的 便利 ， 例 如 我 们 可 以 测试 一 个 包 能 
否 正 向 使 用 ， 单 独 调 用 应 用 的 某 一 个 模块 ， 执 行 简 单 的 计算 等 。 








3.1.3 建立 HTTP 服务 器 


前 面 的 Hello World 程序 对 于 你 来 说 可 能 太 人 简单 了 ， 因 为 这 个 例子 几乎 可 以 在 任何 语言 
的 教科 书 上 找到 对 应 的 内 容 ， 既 无 聊 又 乏味 ， 证 我 们 来 点 儿 不 一 样 的 东西 ， 真 正 感受 一 下 
Node.js 的 魅力 所 在 吧 。 

Node.js 是 为 网 络 而 诞生 的 平台 , 但 又 与 ASP、PHP 有 很 大 的 不 同 , 究竟 不 同 在 哪里 呢 ? 
如 果 你 有 PHP FRAR, 会 知道 在 成 功 运行 PHP 之 前 先 要 配置 一 个 功能 强大 而 复杂 的 HTTP 
HAE, EEUU Apache, IIS 或 Nginx， 还 需要 将 PHP 配置 为 HTTP 服务 需 的 模块 ， 或 者 使 用 
FastCGI 协议 调用 PHP 解释 需 。 这 种 架构 是 “浏览 禹 - HTTP IRE Aè -PHP 解释 各 ”的 组 织 
方式 ， 而 Node.js 采 用 了 一 种 不 同 的 组 织 方 式 ， 如 图 3-1 所 示 。 

我 们 看 到 ，Node.js 将 “HTTP 服 务 顺 ”这 一 层 抽 离 ， 直 接 面 癌 浏览 锅 用 户 。 这 种 架构 
从 某 种 意义 上 来 说 是 颠 履 性 的 ， 因 而 会 让 人 心 存 疑虑 : Node.js 作 为 HTTP 服 务 器 的 效率 
ERU? 会 不 会 提高 耦合 程度 ? 我 们 不 打算 在 这 里 讨论 这 种 架构 的 利 整 ， 后 面 草 节 会 继续 
说 明 。 
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HTTP 服务 如 


(Apache,IIS,etc.) 


图 3-1 Node.js 5 PHP 的 架构 





好 了 了， 回归 正题 ， 让 我 们 创建 一 个 HTTP 服务 硕 吧 。 建 立 一 个 名 为 appjjs 的 文件 ， 内 容 


| /app.Je 
var http - require('http'); 


http.createServer(function(reqg, res) ( 
res.writeHead(200, í('Content-Type': 'text/html']); 
res.write('«hl1»Node.js«/h1»'); 
res.end('«p»Hello World«/p»'); 

)).listen(3000); 


console.log("HTTP server is listening at port 3000."); 





接 下 来 运行 node app .js 命令 ,打开 浏览 各 访问 http:/127.0.0.1:3000， 即 可 看 到 图 3-2 
所 示 的 内 容 。 


e Q ntp/127001. P ~ BÈ X e 127.0.0.1 x | | m yv is 








图 3-2 ”用 Node.js 实现 的 HTTP IKA Ky 
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用 Node.js 实现 的 最 简单 的 HITP 服 务 融 就 这 样 征 生 了 。 这 个 程序 调用 了 Node.js 提供 的 
http 模块 ， 对 所 有 HTTP 请 求 答复 同样 的 内 容 并 监听 3000 端口 。 在 终端 中 运行 这 个 脚本 
时 ， 我 们 会 发 现 它 并 不 像 Hello World 一 样 结束 后 立即 退出 ， 而 是 一 直 等 待 ， 直 到 按 下 Ctrl + 
C 才 会 结束 。 这 是 因为 listen 图 数 中 创建 了 事件 监听 磊 ， 使 得 Node.js 进程 不 会 退出 事件 
循环 。 我 们 会 在 后 面 的 章节 中 详细 介绍 这 其 中 的 奥秘 。 

小 技巧 一 一 使 用 supervisor 

如 果 你 有 PHP 开发 经 验 ， 会 习惯 在 修改 PHP 脚本 后 直接 刷新 浏览 器 以 观察 结果 ， 而 你 
在 开发 Node.js 实现 的 HTTP 应 用 时 会 发 现 ， 无 论 你 修改 了 代码 的 哪 一 部 份 ， 都 必须 终止 
Node.js 再 重新 运行 才 会 奏效 。 这 是 因为 Node.js 只 有 在 第 一 次 引用 到 某 部 份 时 才 会 去 解析 脚 
本 文件 ， 以 后 都 会 直接 访问 内 存 ， 避 免 重 复 载 入 ， 而 PHP 则 总 是 重新 读 取 并 解析 脚本 Cn 
果 没 有 专门 的 优化 配置 )。Node.js 的 这 种 设计 虽然 有 利于 提高 性 能 ， 却 不 利于 开发 调试 ， 
为 我 们 在 开发 过 程 中 总 是 希望 修改 后 立即 看 到 效果 ， 而 不 是 每 次 都 要 终止 进程 并 重启 。 

supervisor 可 以 帮助 你 实现 这 个 功能 ， 它 会 监视 你 对 代码 的 改动 ， 并 自动 重启 Node.js。 
使 用 方法 很 简单 ， 首 先 使 用 npm 安装 supervisor: 
































$ npm install -g supervisor 


如 打 你 使 用 的 是 Linux 或 Mac， 下 接 键 和 信 上 面 的 命令 很 可 能 会 有 权限 错误 。 原 因 是 npm 
需要 把 supervisor 安装 到 系统 目录 ， 需 要 管理 员 授 权 ， 可 以 使 用 sudo nom install -g 
supervisor 命令 来 安装 。 


接 下 来 ， 使 用 supervisor 命令 局 动 app.js: 











$ supervisor app.js 


DEBUG: Running node-supervisor with 
DEBUG: program 'app.js' 

DEBUG: --watch '.' 

DEBUG: --extensions 'nodeļjs' 
DEBUG: --exec 'node' 








DEBUG: Starting child process with 'node app.js' 





DEBUG: Watching directory '/home/byvoid/.' for changes. 
HTTP server is listening at port 3000. 


当代 人 码 被 改动 时 ， 运 行 的 脚本 会 被 终止 ， 然 后 重新 局 动 。 在 终端 中 显示 的 结 玉 如下: 








DEBUG: crashing child 
DEBUG: Starting child process with 'node app.js' 





HTTP server is listening at port 3000. 


supervisor 这 个 小 工具 可 以 解决 开发 中 的 调试 问题 。 
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3.2. 异步 式 I/O 与 事件 式 编程 


Node.js 最 大 的 特点 就 是 异步 式 UO (或 者 非 阻 塞 IO ) 与 事件 紧密 结合 的 编程 模式 。 这 
种 模式 与 传统 的 同步 式 IO 线性 的 编程 思路 有 很 大 的 不 同 ， 因 为 控制 流 很 大 程度 上 要 徘 事 件 
和 回调 函数 来 组 织 ， 一 个 逻辑 要 拆 分 为 若干 个 单元 。 














3.2.1 阻塞 与 线程 


什么 是 阻塞 (block ) 呢 ? 线程 在 执行 中 如 果 遇 到 磁盘 读 写 或 网 络 通信 ( 统称 为 IO 操作 ), 
通常 要 耗费 较 长 的 时 间 ， 这 时 操作 系统 会 剥夺 这 个 线程 的 CPU 控制 权 ， 使 其 暂停 执行 ， 同 
时 将 资源 让 给 其 他 的 工作 线程 ， 这 种 线程 调度 方式 称 为 阻塞 。 当 LO 操作 完毕 时 ,操作 系统 
将 这 个 线程 的 阻塞 状态 解除 ， 恢 复 其 对 CPU 的 控制 权 ， 令 其 继续 执行 。 这 种 IO 模式 就 是 通 
常 的 同步 式 TO (Synchronous I/O ) 或 阻塞 式 LO (Blocking I/O )。 

相应 地 ， 异 步 式 IO ( Asynchronous IO ) 或 非 阻 塞 式 I/O ( Non-blocking VO ) 则 针对 
所 有 VO 操作 不 采用 阻塞 的 策略 。 当 线程 遇 到 TO 操作 时 ， 不 会 以 阻塞 的 方式 等 待 IO 操作 
的 完成 或 数据 的 返回 ， 而 只 是 将 UO 请 求 发 送 给 操作 系统 ， 继 续 执行 下 一 条 语句 。 当 操作 
系统 完成 VO 操作 时 ,以 事件 的 形式 通知 执行 VO 操作 的 线程 ,线程 会 在 特定 时 候 处 理 这 个 
事件 。 为 了 处 理 异步 WO， 线程 必须 有 事件 循环 ， 不断 地 检查 有 没有 未 处 理 的 事件 ， 依 次 予 
以 处 理 。 

阻塞 模式 下 ， 一 个 线程 只 能 处 理 一 项 任务 ， 要 想 提高 吞吐 量 必 须 通 过 多 线程 。 而 非 阻塞 
模式 下 ， 一 个 线程 永远 在 执行 计算 操作 ， 这 个 线程 所 使 用 的 CPU 核心 利用 率 永 远 是 10096, 
UO 以 事件 的 方式 通知 。 在 阻塞 模式 下 ， 多 线程 往往 能 提高 系统 吞吐 量 ， 因 为 一 个 线程 阻塞 
时 还 有 其 他 线程 在 工作 ， 多 线程 可 以 让 CPU 资源 不 被 阻塞 中 的 线程 浪费 。 而 在 非 阻 塞 模式 
下 ， 线 程 不 会 被 IO 阻塞 ， 永 远 在 利用 CPU。 多 线程 带 来 的 好 处 仅仅 是 在 多 核 CPU 的 情况 
下 利用 更 多 的 核 ， 而 Node.js 的 单线 程 也 能 带 来 同样 的 好 处 。 这 就 是 为 什么 Node.js 使 用 了 单 
线程 、 非 阻塞 的 事件 编程 模式 。 

图 3-3 和 图 3-4 分 别 是 多 线程 同步 式 IO 与 单线 程 异步 式 UO 的 示例 。 假 设 我 们 有 一 项 工 
作 ， 可 以 分 为 两 个 计算 部 分 和 一 个 UO 部 分 ，LO 部 分 占 的 时 间 比 计算 多 得 多 (通常 都 是 这 
样 )。 如 有 果 我 们 使 用 阻塞 IO ， 那 么 要 想 获 得 高 并 发 就 必须 开启 多 个 线程 。 而 使 用 异步 式 UO 
时 ， 单 线程 即 可 胜任 。 
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K3-3 ”多 线程 同步 式 VO 





图 3-4 ”单线 程 异步 式 IO 
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单线 程 事 件 驱 动 的 异步 式 VO 比 传统 的 多 线程 阻 突 式 IO 究竟 好 在 哪里 呢 ? 简 而 言 之 ， 
异步 式 UO 就 是 少 了 多 线程 的 开销 。 对 操作 系统 来 说 ， 创 建 一 个 线程 的 代价 是 十 分 郧 吐 的 ， 
需要 给 它 分 配 内 存 、 列 和 调度， 同时 在 线程 切换 的 时 候 还 要 执行 内 存 换 页 ，CPU 的 缓存 被 
清空 ， 切 换 回 来 的 时 候 还 要 重新 从 内 存 中 读 取信 息 ， 破 坏 了 数据 的 局 部 性 。” 

当然 , 异步 式 编程 的 缺点 在 于 不 符合 人 们 一 般 的 程序 设计 思维 ,容易 让 控制 流 变 得 星 深 
难 懂 ,给 编码 和 调试 都 带 来 不 小 的 困难 。 习 惯 传 统 编程 模 式 的 开发 者 在 刚刚 接触 到 大 规模 的 异 
步 式 应 用 时 往往 会 无 所 适 从 , 但 慢 慢 习惯 以 后 会 好 很 多 。 尽管 如 此 , 异步 式 编程 还 是 较为 困难 ， 
不 过 可 喜 的 是 现在 已 经 有 了 不 少 专门 解决 异步 式 编程 问题 的 库 〈 如 async ), 26.2.2747, 

表 3-1 比 较 了 同步 式 VO 和 异步 式 IO 的 特点 。 


表 3-1 同步 式 I/O 和 异步 式 |/O 的 特点 























EFR IO (ER) 异步 式 |/O〈 非 阻塞 式 ) 
利用 多 线程 提供 吞吐 量 FARE BI RT SEHR RS e it 
通过 事件 片 分 割 和 线程 调度 利用 多 核 CPU 通过 功能 划分 利用 多 核 CPU 
需要 由 操作 系统 调度 多 线程 使 用 多 核 CPU 可 以 将 单 进程 绑 定 到 单 核 CPU 
难以 充分 利用 CPU 资源 可 以 充分 利用 CPU 资源 
内 存 轨 迹 大 ， 数 据 局 部 性 弱 内 存 轨迹 小 ， 数 据 局 部 性 强 
符合 线性 的 编程 思维 不 符合 传统 编程 思维 


3.2.2 ”回调 函数 
让 我 们 看 看 在 Node.js 中 如 何 用 异步 的 方式 谈 取 一 个 文件 ， 下 面 是 一 个 例子 : 
//readfile.js 


var fs - require('fs'); 
fs,readPile('file.txc', 'utf-8', function(err, data) 1 
if (err) { 
console.error(err); 
j else ( 
console.log(data); 
j 
IIF 


console.log('end.'); 
运行 的 结果 如 下 : 


end. 
Contents of the file. 


(D 基于 多 线程 的 模型 也 有 相应 的 解决 方案 ， 如 轻 量 级 线程 (lightweightthread ) 等 。 事 件 驱 动 的 单线 程 异 步 模 型 与 多 线 
程 同步 模型 到 底 谁 更 好 是 一 件 非常 有 和 争议 的 事情 ， 因 为 尽管 消耗 资源 ， 后 者 的 否 吐 率 并 不 比 前 者 低 。 
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Node.js 也 提供 了 同步 读 取 文件 的 API: 
//readfilesync.js 


var fs = require('fs'); 

var data - fs.readFileSync('file.txt', 'utf-8'); 
console.log(data); 

console.log('end.'); 


运行 的 结 来 与 前 面 不 同 ， 如 下 所 示 : 





$ node readfilesync.js 
Contents of the file. 
end. 


同步 式 旋 取 文 件 的 方式 比较 容易 理解 ， 将 文件 名 作为 参数 传 入 fs.readFileSync PN 
数 ， 阻 塞 等 待 读 取 完 成 后 ， 将 文件 的 内 容 作 为 函数 的 返回 值 赋 给 Bata 变量 ， 接 下 来 控制 台 
输出 data 的 值 ， 最 后 输出 end.. 

异步 式 读 取 文件 就 稍微 有 些 违反 直觉 了 ，end. 先 被 输出 。 要 想 理 解 结果 ， 我 们 必须 先 
知道 在 Nodejs P, HN IO 是 通过 回调 函数 来 实现 的 。fs .reagdFile 接收 了 三 个 参数 ， 
第 一 个 是 文件 名 ， 第 二 个 是 编码 方式 ， 第 三 个 是 一 个 函数 ， 我 们 称 这 个 函数 为 回调 函数 。 
JavaScript 文 持 匿名 的 函数 定义 方式 ， 辟 如 我 们 例子 中 回调 函数 的 定义 就 是 般 套 在 
fs.readFile 的 参数 表 中 的 。 这 种 定义 方式 在 JavaScript 程序 中 极为 普遍 ， 与 下 面 这 种 定义 
方式 实现 的 功能 是 一 致 的 : 


//readfilecallback.js 














function readFileCallBack(err, data) { 
if (err) { 
console.error(err); 
j else ( 
console.log(data); 
j 
j 


var fs = require('fs'); 
fs.readFile('file.txt', 'utf-8', readFileCallBack); 


console.log('end.'); 


fs.readFile 调用 时 所 做 的 工作 只 是 将 异步 式 VO 请 求 发 送 给 了 操作 系统 ， 然 后 立即 
返回 并 执行 后 面 的 语句 ， 执 行 完 以 后 进入 事件 循环 监听 事件 。 当 fs 接收 到 IO 请 求 完成 的 
事件 时 ， 事 件 循 环 会 主动 调用 回调 函数 以 完成 后 续 工 作 。 因 此 我 们 会 先 看 到 end., PAFI 
file.txt 文件 的 内 容 。 
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4 Node.js 中 ， 并 不 是 所 有 的 API 都 提供 了 同步 和 异步 版 本 。Node.js 不 
警告 鼓励 使 用 同步 IO。 


3.2.3 ”事件 
Node.js 所 有 的 异步 VO 操作 在 完成 时 都 会 发 送 一 个 事件 到 事件 队列 。 在 开发 者 看 来 , 事 


件 由 EventEmitter 对 象 提供 。 前 面 提 到 的 fs.readFile 和 http.createServer 的 回 
调 函 数 都 是 通过 EventEmitter 来 实现 的 。 下 面 我 们 用 一 个 简单 的 例子 说 明 Event Emitter 
的 用 法 : 








//event.js 


var EventEmitter - require('events').EventEmitter; 


var event - new EventEmitter(); 


event.on('some event', function() { 
console.log('some event occured.'); 
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setTimeout(function() { 
event.emit('some event'); 
j, 1000); 


运行 这 段 代 码 ， 1 秒 后 控制 台 输 出 [| some event occured. 其 原理 是 SVert 对 象 
注册 了 事件 some event 的 一 个 监听 希 ， 然 后 我 们 通过 setTimeout TE10002& fb Lm In] 
event 对 象 发 送 事件 some_event ， 此 时 会 调用 some event 的 监听 需 。 

我 们 将 在 4.3.1 节 中 详细 讨论 EventEmitter 对 象 的 用 法 。 

Node.js 的 事件 循环 机 制 

Node.js 在 什么 时 候 会 进入 事件 循环 呢 ? 答案 是 Nodejs 程序 由 事件 循环 开始 ， 到 事件 循 
环 结束 ， 所 有 的 逻辑 都 是 事件 的 回调 函数 ， 所 以 Node.js 始终 在 事件 循环 中 ， 程 序 入 口 就 是 
事件 循环 第 一 个 事件 的 回调 号 数 。 事 件 的 回调 函数 在 执行 的 过 程 中 ， 可 能 会 发 出 VO 请 求 或 
HÈRA (Cemit) 事件 ， 执 行 完 毕 后 再 返回 事件 循环 ， 事件 循环 会 检查 事件 队列 中 有 没有 未 
处 理 的 事件 ， 下 到 程序 结束 。 图 3-5 说 明了 事件 循环 的 原理 。 

与 其 他 语言 不 同 的 是 ,Nodejs 没有 显 式 的 事件 循环 ,类 似 Ruby 的 EventMachine: :run () 
HJ PRIZE Node.js 中 是 不 存在 的 Nodejs 的 事件 循环 对 开发 者 不 可 见 , 由 1ibev 库 实 现 。lLipev 
支持 多 种 类 型 的 事件 ， 如 ev_io、ev_timer、ev_signal、ev_idle 等 , 在 Node.js 中 均 被 
EventEmitter 封装 。1ibev 事件 循环 的 每 一 次 进 代 ,看 Node.js 中 就 是 一 次 Tick，libev 不 
断 检 查 是 否 有 活动 的 、 可 供 检 测 的 事件 监听 备 ， 和 直到 检测 不 到 时 才 退 出 事件 循环 ， 进 程 结 
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回调 函数 事件 循环 





ZH 







ar pR 


图 3-5 事件 循环 


3.89 ”模块 和 包 


模块 (Module ) FIE ( Package ) 是 Node.js 最 重要 的 支柱 。 开 发 一 个 具有 一 定 规 模 的 程 
序 不 可 能 只 用 一 个 文件 , 通 津 需要 把 各 个 功能 拆 分 、 封 装 ， 然后 组 合 起 来 ,模块 正 是 为 了 实 
现 这 种 方式 而 媳 生 的 。 在 浏览 各 JavaScript 中 ， 脚 本 模块 的 拆 分 和 组 合 通 常 使 用 HTML 的 
script 标签 来 实现 。Node.js 提供 了 require 函数 来 调用 其 他 模块 ， 而 且 模 块 都 是 基于 
文件 的 ， 机 制 十 分 简单 。 

Node.js 的 模块 和 包机 制 的 实现 参照 了 CommonJS 的 标准 ， 但 并 未 完全 遵循 。 不 过 
两 者 的 区 别 并 不 大 , 一 般 来 说 你 大 可 不 必 担 心 ， 只 有 当 你 试图 制作 一 个 除了 支持 Node.js 
之 外 还 要 文 持 其 他 平台 的 模块 或 包 的 时 候 才 需要 仔细 人 研究。 通常 ， 两 者 没有 下 接 冲 突 的 
地 方 。 

我 们 经 常 把 Nodes 的 模块 和 包 相 提 并 论 ， 因 为 模块 和 包 是 没有 本 质 区 别 的 ， 两 个 概念 
也 时 第 混用 。 如 末 要 辨析 ， 那 么 可 以 把 包 理 解 成 是 实现 了 有 某 个 功能 模块 的 集合 ， 用 于 发 布 
和 维 扩 。 对 使 用 者 来 说 ,模块 和 包 的 区 别 是 透明 的 ， 因 此 经 常 不 作 区 分 。 本 市 中 我 们 会 详 


细 介 绍 : 
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a 什么 是 模块 ; 

a 如 何 创 建 并 加 载 模块 ; 
a 如 何 创 建 一 个 包 ; 

a 如 何 使 用 包 管 理 融 ; 


3.3.1 什么 是 模块 


模块 是 Node.js 应 用 程序 的 基本 组 成 部 分 ， 文 件 和 模块 是 一 一 对 应 的 。 换 言 之 ,一 个 
Node.js 文件 就 是 一 个 模块 , 这 个 文件 可 能 是 JavaScript 代码、JSON 或 者 编 府 过 的 C/C++ 扩展 。 

在 前 面 草 市 的 例子 中 ， 我 们 曾经 用 到 了 var http = require('http'), 其 中 NEED 
是 Node.js 的 一 个 核心 模块 ， 其 内 部 是 用 C++ 实现 的 ， 外 部 用 JavaScript 封 狼 。 我 们 通过 
require 图 数 获取 了 这 个 模块 ， 然 后 才能 使 用 其 中 的 对 象 。 











3.3.2 创建 及 加 载 模 块 


介绍 了 什么 是 模块 之 后 ， 下 面 我 们 来 看 看 如 何 创 建 并 加 载 它 们 。 

1. 创建 模块 

在 Nodejs 中 ， 创 建 一 个 模块 非常 简单 ， 因 为 一 个 文件 就 是 一 个 模块 ， 我 们 要 关注 的 问 
题 仅 仅 在 于 如 何在 其 他 文件 中 获取 这 个 模块 。Node.js 提供 了 exports 和 require 两 个 对 
JR, HHP exports 是 模块 公开 的 接口 ，require 用 于 从 外 部 获取 一 个 模块 的 接口 ， 即 所 获 
取 模 块 的 exports XZ- 

让 我 们 以 一 个 例子 来 了 解 模块 。 创 建 一 个 module.js 的 文件 ， 内 容 是 : 





//module.js 

var name; 

exports.setName = function(thyName) { 
name = thyName; 
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exports.sayHello = function() ( 
console.log('Hello ' + name); 

^3 
PE . F 

在 同一 目录 下 创建 getmodule.js， 内 容 是 : 


//getmodule.js 


var myModule - require('./module'); 
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myModule.setName('BYVoid'); 
myModule.sayHello(); 


运行 node getmodule.js, £54&J&: 
Hello BYVoid 


在 以 上 示例 中 ，module.js 通过 exports 对 象 把 setName 和 sayHello 作为 模块 的 访 
问 接口 ， 在 getmodule.js 中 通过 require('./module') 加 载 这 个 模块 ， 然 后 就 可 以 直接 访 
问 module.js 中 exports X ZB p PRACT -0 

APOR RITARA HERBA, EARE, RIA EREA, 
符合 传统 的 编程 逻辑 。 在 这 个 基础 上 , 我 们 可 以 构建 大 型 的 应 用 程序 ，npm 提供 的 上 万 个 模 
块 都 是 通过 这 种 简单 的 方式 搭建 起 来 的 。 

2. 单 次 加 载 

上 上面 这 个 例子 有 点 类 似 于 创建 一 个 对 象 ， 但 实际 上 和 对 象 又 有 本 质 的 区 别 ， 因 为 
recuire 不 会 重复 加 载 模块 ， 也 就 是 说 无 论调 用 多 少 次 require, 获得 的 模块 都 是 同一 个 。 
我 们 在 getmodulejs 的 基础 上 稍 作 修改 : 








//loadmodule.js 


var hellol = require('./module'); 
hellol.setName('BYVoid'); 


var hello2 - require('./module'); 
hello2.setName('BYVoid 2'); 


hellol.sayHello(); 





运行 后 发 现 输出 结果 是 Hello BYVoid 2， 这 是 因为 变量 hellol 和 hel1o2 指向 的 是 
同一 个 实例 ， 因此 hellol.setName 的 结果 被 hello2.setName f s 最 终 输 出 结果 是 
由 后 者 决定 的 。 

3. i8 i exports 


有 时 候 我 们 只 是 想 把 一 个 对 象 封闭 到 模块 中 ， 例 如 : 








//singleobject.js 


function Hello() ( 


var name; 


this.setName - function (thyName) ( 
name - thyName; 


J3 
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this.sayHello = function () ( 
console.log('Hello ' + name); 
It: 
i 


exports.Hello - Hello; 


此 时 我 们 在 其 他 文件 中 需要 通过 require('./singleobject').Hello 来 获取 


Hello 对 象 ， 这 上 略 显 见 余 ， 可 以 用 下 面 方法 稍微 简化 : 
//hello.js 


function Hello() ( 


var name; 


this.setName = function(thyName) { 
name - thyName; 


}; 
this.sayHello = function() ( 
console.log('Hello ' + name); 
Jg 
I3 
module.exports - Hello; 
NY YA [y Y 3 = ZZ 日 NY 
这 样 就 可 以 直接 获得 这 个 对 象 了 : 
//gethello.js 
var Hello - require('./hello'); 
hello = new Hello(); 


hello.setName('BYVoid'); 
hello.sayHello(); 


注意 ， 模块 接口 的 唯一 变化 是 使 用 module.exports = Hello 代替 了 exports.Hello- 
Hello。 在 外 部 引用 该 模块 时 ， 其 接口 对 象 就 是 要 输出 的 Hello 对 象 本 身 ， 而 不 是 原先 的 





exportSso 


事实 上 ，exports 本 身 仅仅 是 一 个 普通 的 空 对 象 ， 即 {}， 它 专门 用 来 声明 接口 ， 本 
质 上 是 通过 它 为 模块 闭 包 "的 内 部 建立 了 一 个 有 限 的 访问 接口 。 因 为 它 没 有 任何 特殊 的 地 方 ， 


所 以 可 以 用 其 他 东西 来 代替 ， 璧 如 我 们 上 面 例子 中 的 Hello 对 和 象 。 


CD 闭 包 是 函数 式 编 程 语言 的 常见 特性 ， 具 体 说 明 见 本 书 附录 A。 
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不 可 以 通过 对 exports 直接 赋值 代替 对 module.exports 赋值 。 
exports 实际 上 只 是 一 个 和 module.exports 指向 同一 个 对 象 的 变量 ， 
它 本 身 会 在 模块 执行 结束 后 释放 ,但 module 不 会 ， 因 此 只 能 通过 指定 
module.exports 来 改变 访问 接口 。 





3.3.3 创建 包 


包 是 在 模块 基础 上 更 深 一 步 的 抽象 ，Node.js 的 包 类 似 于 C/C++ 的 图 数 库 或 者 Java/.Net 
的 类 库 。 它 将 某 个 独立 的 功能 封 猴 起 来 , 用 于 发 布 、 更 新 、 依 赖 管理 和 版 本 控制 。Node.js 根 
据 CommonJS 规范 实现 了 包机 制 ， 开 发 了 npm 来 解决 包 的 发 布 和 获取 需求 。 

Node.js 的 包 是 一 个 目录 ， 其 中 包含 一 个 JSON 格式 的 包 说 明文 件 package.json。 严 格 符 
合 CommonJS 规范 的 包 应 该 具备 以 下 特征 : 

口 package.json 必须 在 包 的 项 层 目 录 下 ; 

a 二 进 制 文件 应 该 在 bin 目录 下 ; 

O JavaScript 代码 应 该 在 lib HX F; 

口 文档 应 该 在 doc 目录 下 ; 

口 单元 测试 应 该 在 test 目录 下 。 

Node.js 对 包 的 要 求 并 没有 这 人 么 严格 ， 只 要 顶层 目录 下 有 package.json， 并 符合 一 些 规范 
即 可 。 当 然 为 了 提高 兼容 性 ， 我 们 还 是 建议 你 在 制作 包 的 时 候 ， 严 格 遵守 CommonJS 规范 。 

1. 作为 文件 夹 的 模块 

模块 与 文件 是 一 一 对 应 的 。 文 件 不 仅 可 以 是 JavaScript 代码 或 二 进 制 代码 ， 还 可 以 是 一 
个 文件 夹 。 最 简单 的 包 ， 就 是 一 个 作为 文件 夹 的 模块 。 下 面 我 们 来 看 一 个 例子 ， 建 立 一 个 叫 
做 somepackage 的 文件 夹 ， 在 其 中 创建 mdex.js， 内 容 如 下 : 





























//somepackage/index.js 
exports.hello = function() { 
console.log('Hello.'); 
}; 
然后 在 somepackage 之 外 建立 getpackage.js， 内 容 如 下 : 
//getpackage.js 


var somePackage - require('./somepackage'); 


somePackage.hello(); 
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运行 node getpackage.js， 控 制 台 将 输出 结果 mello.. 

我 们 使 用 这 种 方法 可 以 把 文件 夹 封闭 为 一 个 模块 ， 即 所 谓 的 包 。 包 通 常 是 一 些 模 块 的 集 
A. 在 模块 的 基础 上 提供 了 更 高 层 的 抽象 ,相当 于 提供 了 一 些 固 定 接口 的 晒 数 库 。 通 过 定制 
package.json， 我 们 可 以 创建 更 复杂 、 更 完善 、 更 符合 规范 的 包 用 于 发 布 。 

2. package .json 

在 前 面 例子 中 的 somepackage 文件 夹 下 , 我们 创建 一 个 叫做 package.json 的 文件 ， 内 容 如 
下 所 示 : 


{ 
"main" s "./lib/interface.js" 


j 

然后 将 index.js 重 命 名 为 interface.js 并 放 入 lib 子 文件 夹 下 。 以 同样 的 方式 再 次 调用 这 个 
包 ， 依 然 可 以 正常 使 用 。 

Node.js 在 调用 某 个 包 时 ， 会 首先 检查 包 中 package.json 文件 的 main 字段 ， 将 其 作为 
包 的 接口 模块 ， 如 果 package.json 或 main 字段 不 存在 ， 会 答 试 寻找 index.js 或 index.node TE 
为 包 的 接口 。 

package.json 是 CommonJS 规定 的 用 来 描述 包 的 文件 ， 完 全 符合 规范 的 package.json X 
件 应 该 含有 以 下 字段 。 

O name: 包 的 名 称 ， 几 须 是 唯一 的 ， 由 小 写 喘 文字 母 、 数 字 和 下 划 线 组 成 ， 不 能 包含 
空格 。 
description: 包 的 简要 说 明 。 
version: 符合 语义 化 版 本 识别 "规范 的 版 本 字符 串 。 
keywords: 关键 字数 组 ， 通 常用 于 搜索 。 
maintainers: 维护 者 数组 ， 每 个 元 录 要 包含 name. email (可 选 )、web (可 选 ) 
字段 。 

O contributors: 页 献 者 数组 ， 格式 与 maintainers 相 同 。 包 的 作者 应 该 是 页 献 者 
数组 的 第 一 个 元 系 。 

O bugs: 提交 bug 的 地 址 ， 可 以 是 网 址 或 者 电子 邮件 地 址 。 

O licenses: 许可 证 数组 ， 每 个 元 素 要 包含 type (许可 证 的 名 称 ) Murli (链接 到 
许可 证 文本 的 地 址 ) 字段 。 

O repositories: 仓库 托管 地 址 数组 , 每 个 元 条 要 包含 type ( 仓库 的 类 型 ,如 git 小 
url (仓库 的 地 址 ) 和 path 〈 相 对 于 仓库 的 路 径 ， 可 选 ) 字段 。 





























DD DODO 

















D 语义 化 版 本 识别 ( Semantic Versioning ) 是 由 Gravatars 和 GitHub 创始 人 Tom Preston-Werner 提出 的 一 套 版 本 命名 
规范 ， 最 初 目的 是 解决 各 式 各 样 版 本 号 大 小 比较 的 问题 ， 目 前 被 许多 包 管 理 系 统 所 采用 。 
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O dependencies: 包 的 依赖 ， 一 个 关联 数组 ， 由 包 和 名 称 和 版 本 号 组 成 。 
下 面 是 一 个 完全 符合 CommonJS 规范 的 package.json 示例 : 


"name": "mypackage", 
"description": "Sample package for CommonJS. This package demonstrates the required 
elements of a CommonJS package.", 





"version": "0.7.0", 
"keywords": [ 
"package", 
"example" 
l, 
"maintainers": [ 
{ 
"name": "Bill Smith", 
"email": "bills@example.com", 
j 
l, 
"contributors": I 
{ 
"name": "BYVoid", 
"web": "http://www.byvoid.com/" 
j 
l, 
"bugs": { 
"mail": "dev@example.com", 
"web": "http://www.example.com/bugs" 
m 
"licenses": [ 
{ 
"type": "GPLv2", 
"url": "http://www.example.org/licenses/gpl.html" 
】 
l, 
"repositories": [ 
{ 
"popetr "git"; 
"url": "http://github.com/BYVoid/mypackage.git" 
】 
l, 
"dependencies": { 
"webkit": "1.2", 
"ssl" A 
"gnutis"s ["1-0"; 4 0] 
"openssl": "0.9.8" 
】 
】 
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3.83.4 Node,js 包 管 理 器 


Node.js 包 管理 器 ， 即 npm 是 Node.js 官方 提供 的 包 管 理工 具 ?"， 它 已 经 成 了 Node.js 包 的 
标准 发 布 平 台 ， 用 于 Nodejs 包 的 发 布 、 传 播 、 依 赖 控 制 。npm 提供 了 命令 行 工具 ， 使 你 可 
以 方便 地 下 载 、 安 装 、 升 级 、 删 除 包 ， 也 可 以 让 你 作为 开发 者 发 布 并 维护 包 。 

1. 获取 一 个 包 

使 用 npm 安装 包 的 命令 格式 为 : 





npm [install/i] [package name| 


例如 你 要 安装 express， 可 以 在 命令 行 运行 : 





$ npm install express 
或 者 : 
$ npm i express 


随后 你 会 看 到 以 下 安装 信息 : 


N 


m http GET https://registry.npmjs.org/express 
npm http 304 https://registry.npmjs.org/express 

m http GET https://registry.npmjs.org/mime/1.2.4 
pm http GET https://registry.npmjs.org/mkdirp/0.3.0 


)m http GET https://registry.npmj]s.org/dqs 





pm http GET https://registry.npm]s.org/conneogot 
pm http 200 https://registry.npmjs.org/mime/1.2.4 
)bm http 200 hbttpsi//reogistry.npmjs.orgy/ds 


pm http GET https://registry.npmjs.org/mime/-/mime-1.2.4.tgz 





ipm http GET httpe://registry.n 


p 

p 

pmjs.org/mkdirp/-/mkdirp-0.3.0.tgz 
m http 200 https://registry.npmjs.org/mime/-/mime-1.2.4.tgz 

p 

p 

p 





)pm http 200 https://registry.npmjs.org/mkdirp/-/mkdirp-0.3.0.tgz 
npm http 200 https://registry.n 
npm http GET https://registry.n 


npm http 200 https://registry.npmjs.org/formidable 


p 

p 

p 

p 

p 

p 

p 

npm http 200 https://registry.npmj]s.org/mkdirp/0.3.0 
p 

p 

p 

p 

p 

p mjs.org/connect 
p 


mjs.org/formidable 





























express802.5.8 ./node modules/express 
mime@1 .2.4 

— mkdirp@0.3.0 

— qs@Q0.4.2 

— connect6e1.8.5 


此 时 express WERNI T, FHEA A HRE node modules HX Fo npm Æ 











(D npm Ż F Node.js, 就 像 pip Z F Python, gem Z F Ruby, pear 2 F PHP, CPAN ZZ TF Perl .……: 同时 也 像 apt-get 之 
于 Debian/Ubutnu, yum 之 于 Fedora/RHEL/CentOS, homebrew 之 于 Mac OS X, 
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获取 express 的 时 候 还 将 自动 解析 其 依赖 ， 并 获取 express 依赖 的 mime、mkdirp、 
qs 和 connect, 

2. 本 地 模式 和 全 局 模式 

npm 在 默认 情况 下 会 从 http:/npmjs.org 搜 索 或 下 载 包 , 将 包 安 装 到 当前 目录 的 node_modules 
子 目录 下 。 











如 果 你 熟悉 Ruby 的 gem 或 者 Python 的 pip， 你 会 发 现 npm 与 它们 的 
行为 不 同 ，gem X pip 总 是 以 全 局 模式 安装 ， 使 包 可 以 供 所 有 的 程序 使 用 ， 
m npm 默认 会 把 包 安 装 到 当前 目录 下 。 这 反映 了 npm 不 同 的 设计 哲学 。 如 
果 把 包 安 装 到 全 局 ， 可 以 提高 程序 的 重复 利用 程度 ， 避 免 同 样 的 内 容 的 多 
份 副本 ， 但 坏处 是 难以 处 理 不 同 的 版 本 依赖 。 如 果 把 包 安 装 到 当前 目录 ， 
或 者 说 本 地 ， 则 不 会 有 不 同 程序 依赖 不 同 版 本 的 包 的 冲突 问题 ， 同 时 还 减 
轻 了 包 作 者 的 API 兼 容 性 压力 , 但 缺陷 则 是 同一 个 包 可 能 会 被 安装 许多 次 。 


在 使 用 npm 安装 包 的 时 候 , 有 两 种 模式 :本 地 模式 和 全 局 模式 ,默认 情况 下 我 们 使 用 nom 
instal1 命 令 就 是 采用 本 地 模式 , 即 把 包 安 装 到 当前 目录 的 node modules 7 H% F o Node.js 
HJ require 在 加 载 模块 时 会 符 试 搜寻 node modules 子 目 录 ， 因 此 使 用 npm 本 地 模式 安装 
的 包 可 以 直接 被 引用 。 

npm 还 有 另 一 种 不 同 的 安装 模式 被 成 为 全 局 模式 ， 使 用 方法 为 : 

















npm [install/i] -g [package name] 


与 本 地 模式 的 不 同 之 处 就 在 于 多 了 一 个 参数 -g。 我 们 在 介绍 supervisor 那 个 小 节 中 使 用 
了 npm install -g supervisor 命令 ， 就 是 以 全 局 模式 安装 supervisors 

为 什么 要 使 用 全 局 模式 呢 ? 多 数 时 候 并 不 是 因为 许多 程序 都 有 可 能 用 到 它 , 为 了 减少 多 
重 副本 而 使 用 全 局 模式 ， 而 是 因为 本 地 模式 不 会 注册 PATH 环境 变量 。 举 例 说 明 ， 我们 安装 
supervisor 是 为 了 在 命令 行 中 运行 它 ， 壁 如 直接 运行 supervisor scriptjs， 这 时 就 需要 在 PATH 
环境 变量 中 注册 supervisor。npm 本 地 模式 仪 仅 是 把 包 安 装 到 node modules 子 目 录 下 ， 其 中 
HJ bin 目录 没有 包含 在 PATH 环境 变量 中 ， 不 能 直接 在 命令 行 中 调用 。 而 当 我 们 使 用 全 局 模 
式 安装 时 , npm 会 将 包 安 疙 到 系统 目录 , 壁 如 /usr/local/lib/node modules/, 同时 package.json X 
件 中 bin 字段 包含 的 文件 会 被 链接 到 /usr/local/bin/。/usr/local/bin/ 是 在 PATH 环境 变量 中 默认 
定义 的 ， 因 此 就 可 以 直接 在 命令 行 中 运行 supervisor script.js 命 令 了 。 


















































V. 使 用 全 局 模式 安装 的 包 并 不 能 直接 在 JavaScript 文件 中 用 require 获 
提示 得 ， 因 为 require 不 会 搜索 /usr/local/lib/node modules/。 我 们 会 在 第 6 草 
详细 介绍 模块 的 加 载 顺序 。 
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本 地 模式 和 全 局 模式 的 特点 如 表 3-2 所 示 。 
表 3-2 ”本 地 模式 与 全 局 模式 


模 式 可 通过 require 使 用 注册 PATH 
本 地 模式 是 f 
全 局 模式 f 十 


总 而 言 之 ， 当 我 们 要 把 某 个 包 作 为 工程 运行 时 的 一 部 分 时 , 通过 本 地 模式 获取 ， 如 果 要 
在 命令 行 下 使 用 ， 则 使 用 全 局 模式 安装 。 


在 Linux/Mac 上 使 用 npm install -dg 安装 时 有 可 能 需要 root 权限 ， 
提示 为 /usr/localllib/node modules/ 通常 只 有 管理 员 才 有 权 写 入 。 





3. 创建 全 局 链接 

npm 提供 了 一 个 有 趣 的 命令 npm 1ink， 它 的 功能 是 在 本 地 包 和 全 局 包 之 间 创 建 符号 链 
接 。 我 们 说 过 使 用 全 局 模式 安装 的 包 不 能 直接 通 过 require 使 用 ,但 通过 nom 1ink 命 令 
可 以 打破 这 一 限制 。 举 个 例子 ， 我们 已 经 通过 npm install -g express EJ express, 
这 时 在 工程 的 目录 下 运行 命令 : 





$ npm link express 
./node modules/express -> /usr/local/lib/node modules/express 


我 们 可 以 在 node modules FH 3er 4 T8 Ie] 2 RESI A EB BLBRE T REDE. IX 
种 方法 ， 我 们 就 可 以 把 全 局 包 当 本 地 包 来 使 用 了 。 














"y npm link 命令 不 支持 Windows. 
T 





除了 将 全 局 的 包 链 接 到 本 地 以 外 ， 使 用 npm 1Link 命 令 还 可 以 将 本 地 的 包 链 接 到 全 局 。 
使 用 方法 是 在 包 目 录 ( package.json 所 在 目录 ) 中 运行 npm link 命令 。 如 果 我 们 要 开发 
一 个 包 ， 利 用 这 种 方法 可 以 非常 方便 地 在 不 同 的 工程 间 进 行 测试 。 

4. 包 的 发 布 

npm 可 以 非常 方便 地 发 布 一 个 包 ， 比 pip. gem, pear 要 简单 得 多 。 在 发 布 之 有 前， 首先 
需要 让 我 们 的 包 符 合 npm 的 规范 , npm 有 一 套 以 CommonJS 为 基础 包 规 范 , 但 与 CommonJS 
并 不 完全 一 致 ， 其 主要 差别 在 于 必 填 字段 的 不 同 。 通 过 使 用 npm init 可 以 根据 交互 式 问答 
产生 一 个 符合 标准 的 package.json， 例 如 创建 一 个 名 为 byvoidmodule 的 目录 ， 然 后 在 这 个 
目录 中 运行 npm init: 
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$ npm init 
Package name: (byvoidmodule) byvoidmodule 
Description: A module for learning perpose. 





Package version: (0.0.0) 0.0.1 

Project homepage: (none) http://www.byvoid.com/ 
Project git repository: (none) 

Author name: BYVoid 

Author email: (none) byvoid.kcpGgmail.com 
Author url: (none) http://www.byvoid.com/ 

Main module/entry point: (none) 


Test command: (none) 
What versions of node does it run on? (0.6.10) 
About to write to /home/byvoid/byvoidmodule/package.json 





"author": "BYVoid «byvold.kcopegmaril.com» (Hhttps/Jwww.byvold.com/)'", 
"name": "byvoidmodule", 
"description": "A module for learning perpose.", 
"version": "0.0.1", 
"homepage": "http://www.byvoid.com/", 
"repository": { 
"Vue [^s 
la 
"engines": { 
"node": "~0.6.12" 
- 
"dependencies": {}, 
"devDependencies": {} 





Is this ok? (yes) yes 


这 样 就 在 byvoidmodule 目录 中 生成 一 个 符合 npm 规范 的 package.json 文件 。 创 建 一 个 
index.js 作为 包 的 接口 ， 一 个 简单 的 包 就 制作 完成 了 。 

在 发 布 前 ， 我 们 还 需要 获得 一 个 账号 用 于 今后 维护 自己 的 包 ， 使 用 npm adduser 根据 
提示 输入 用 户 名 、 密 码 、 邮 箱 ， 每 待 账号 创建 完成 。 完 成 后 可 以 使 用 nom whoami 测验 是 
否 已 经 取得 了 账号 。 

接 下 来 ， 在 package.json 所 在 目录 下 运行 npm publish， 稍 等 片刻 就 可 以 完成 发 布 了 。 
打开 浏览 器 ,访问 http://search.npmjs.org/ 就 可 以 找到 自己 刚刚 发 布 的 包 了 。 现在 我 们 可 以 在 
世界 的 任意 一 人 台 计 算 机 上 使 用 npm install byvoidmodule 命令 来 安装 它 。 图 3-6 是 npmjs. 
org 上 包 的 描述 页 面 。 

如 果 你 的 包 将 来 有 更 新 ， 只 需要 在 package.json 文件 中 修改 version 字段 ， 然 后 重新 
使 用 npm publish 命令 就 行 了 。 如 果 你 对 已 发 布 的 包 不 满意 (比如 我 们 发 布 的 这 个 毫 无 意 
义 的 包 )， 可 以 使 用 npm unpublish 命令 来 取消 发 布 。 
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Dnpm registry 
c CQ f  (search.npmjs.org/4/byvoidmodule EJ s» pr a 


npm registry 


byvoidmodule hpi/wwwbyvoid.com 


Last updated: just now 


by: BYVoid 
latest (0.0.1) Description A module for learning perpose. 
0.0.1 Version 0.0.1 
Dependencies 
Homepage http://www.byvoid.com/ 
Repository undefined: 
Engines node (-0.6.10) 


People who starred byvoidmodule 


How To: Install npm Publish a package more 


K|3-6 1E npm 上 发 布 的 包 


3.4 ”调试 


写 程 序 时 免不了 遇 到 bug， 而 当 bug 发 生 以 后 ， 除 了 抓 耳 挠 腮 之 外 ， 一 个 常用 的 技术 是 
单 步调 试 。 在 写 C/C++ 程序 的 时 候 ， 我 们 有 Visual Studio, gdb 这 样 顺 手 的 调试 种， 而 脚本 
语言 开发 者 就 没有 这 么 好 的 待遇 了 。 多 年 以 来 , 像 JavaScript 语言 一 直 缺 乏 有 效 的 调试 手段 ， 
“ 攻 城 师 ” 只 能 依 徘 “ 眼 观 六 路 ， 耳 听 八 方 ” 的 方式 进行 静态 查 错 ， 或 者 在 代码 之 间 添 加 大 
长 的 输出 语句 来 分 析 可 能 出 错 的 地 方 。 下 到 有 了 FireBug, Chrome 开发 者 工具 , JavaScript 才 
算 有 了 基本 的 调试 工具 。 在 没有 编译 着 或 解 译 硕 的 文 持 下 ,为 缺乏 内 省 机 制 的 语言 实现 一 人 1 
调试 需 是 几乎 不 可 能 的 。Nodejjs 的 调试 功能 正 是 由 V8 提供 的 ,保持 了 一 贯 的 高 效 和 方便 的 
特性 。 尽 管 你 也 许 已 经 对 原始 的 调试 方式 十 分 适应 ， 而 且 有 了 一 套 高 效 的 调试 技巧 ,但 我 们 
还 是 想 介绍 一 下 如 何 使 用 Node.js 内 置 的 工具 和 第 三 方 模块 来 进行 单 步调 试 。 

















3.4.8 命令 行 调试 
Node.js 文 持 命令 行 下 的 单 步调 试 。 下 面 是 一 个 简单 的 程序 : 


i 


"world's 


var a 


var b 





参 


2 
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var c = function(x) { 
console.log('hello ' + x + a); 
Hi 
eS 


在 命令 行 下 执行 node debug daebug.js， 将 会 启动 调试 工具 : 


< debugger listening on port 5858 


connecting... 


ok 


break in /home/byvoid/debug.js:1 











1 var a - 1; 

2 Var b = 'world'; 

3 var c = function(x) { 

debug> 
这 样 就 打开 了 一 个 Node.js 的 调试 终 问 ,我 们 可 以 用 一 些 基 本 的 命令 进行 单 步 跟 踪 调 试 ， 
见 表 3-3。 
表 3-3 Node.js 调试 命令 
Mm F 功 能 

run 执行 脚本 ， 在 第 一 行 暂 集 
restart 重新 执行 脚本 
cont, c 继续 执行 ， 直 到 遇 到 下 一 个 断 点 
next, n 单 步 执行 
step, sS 单 步 执行 并 进入 函数 
Otto. D 从 函数 中 步 出 
setBreakpoint(), sb() 在 当前 行 设置 断 点 
setBreakpoint('f()'), sb(...) 在 函数 f 的 第 一 行 设 置 断 点 
SEEBEGSaRGGTE SG 0 SDi 在 script.js 的 第 20 行 设置 断 点 
clearBreakpoint, cb(...) THER PU BB 
backtrace, bt 显示 当前 的 调用 栈 
ligti(5) 显示 当前 执行 到 的 前 后 5 行 代码 


watch(expr) 


unwatch(expr) 


watchers 


repl 


kill 


scripts 


version 


把 表达 式 expr 加 入 监视 列表 

把 表达 式 expr 从 监视 列表 移 除 
显示 监视 列表 中 所 有 的 表达 式 和 值 
在 当前 上 下 文 打开 即时 求 值 环境 
终止 当前 执行 的 脚本 

显示 当前 已 加 载 的 所 有 脚本 

显示 V8 的 版 本 
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下 面 是 一 个 简单 的 例子 : 


$ node debug debug.js 
« debugger listening on port 5858 
connecting... ok 


break in /home/byvoid/debug.js:1 





l var a = 1; 
2 var b = world's 
3 var c = function (x) ( 
debug» n 
break in /home/byvoid/debug.js:2 
1 var a = 1; 
2 var b = 'world'; 
3 var c = function (x) ( 
4 console.log('hello ' + x + a); 


debug» sb('debug.js', 4) 


1 var a = 1; 
2 var b = "world's 
3 var c = function (x) ( 
* 4 console.log('hello ' + x + a); 
9 Jf 
6 cb); 
7 h)? 
debug» c 
break in /home/byvoid/debug.js:4 
2 var b = 'world'; 
3 var c = function (x) ( 
* d console.log('hello ' + x + a); 
S. x34 
6 c(b); 


debug> repl 

Press Ctrl + C to leave debug repl 
> X 

'world' 

> a+ 1 

2 

debug> c 

< hello worldl 


program terminated 


3.4.2 ”远程 调试 
V8 提供 的 调试 功能 是 基于 TCP 协议 的 ， 因 此 Node.js 可 以 轻松 地 实现 远程 调试 。 在 命 
令 行 下 使 用 以 下 两 个 语句 之 一 可 以 打开 调试 服务 右 : 


node --debug[-port] script.js 
node --debug-brki[-port] script.js 
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node --debug 命令 选项 可 以 局 动 调试 服务 融 ， 默 认 人 情况 下 调试 端口 是 5838， 也 可 以 
使 用 --debug-1234 指定 调试 端口 为 1234。 使 用 --aebug 选项 运行 脚本 时 ， 脚 本 会 正常 
执行 ,但 不 会 暂停 , 在 执行 过 程 中 调试 客户 端 可 以 连接 到 调试 服务 硕 。 如 果 要 求 脚 本 和 暂停 执 
行 等 待 客户 端 连 接 ， 则 应 该 使 用 --debug-brk 选项。 这 时 调试 服务 器 在 启动 后 会 立刻 暂停 
执行 脚本 ， 等 待 调试 客户 端 连接。 

当 调 试 服 务 需 局 动 以 后 ， 可 以 用 命令 行 调 试 工具 作为 调试 客户 端 连 接 ， 例 如 : 


/ | &&— ^R 
$ node --debug-brk debug.js 








debugger listening on port 5858 


// 在 另 一 个 终端 中 
$5 node debug 127.0.0.1:5858 


connecting... ok 
debug» n 
break in /home/byvoid/debug.js:2 
1 var a = 1; 
2 var b = 'world'; 
3 var c = function (x) ( 
4 console.log('hello ' + x + a); 
debug» 


XE, MEH node debug debug.js 命令 调试 时 ， 只 不 过 是 用 Nodejs 命令 行 工 
具 将 以 上 两 步 工作 自动 完成 而 已 。 


3.4.3 ”使 用 Eclipse 调试 Node.js 


基于 Node.js 的 远程 调试 功能 ， 我 们 甚至 可 以 用 文 持 V8 调试 协议 的 IDE 调试 ， 例 如 强 
大 的 Eclipse, Eclipse 是 次 受 广 大 “人 码 农 ”喜爱 的 集成 开发 环境 ， 有 Java 开发 经 验 的 对 它 一 
定 不 会 阳 生 。 在 这 一 人 小节， 我 们 将 会 学 会 如 何 使 用 Eclipse 配置 Node.js 的 调试 环境 ， 并 实现 
单 步 调试 功能 。 

1. 配置 调试 环境 

在 使 用 Eclipse 之 前 , 首先 需要 安装 JDK, 可 以 在 http:/wwwi.oracle.com/technetwork/java/ 
javase/downloads/index.html 获得 , 然后 在 http:/www.eclipse.org/downloads/ 取得 一 份 Eclipse. 

启动 Eclipse, WEH Help 一 Install New Software...， 此 时 会 打开 一 个 安装 对 话 框 ， 
点 击 右边 的 按钮 Add...， 接 下 来 会 打开 一 个 标题 为 Add Repository 的 对 话 框 ， 在 Location 中 输 
入 http://chromedevtools.googlecode.com/svn/update/dev/，Name 中 输入 Chrome Developer， 然 
后 点 击 OK 按 钮 。 参 见 图 3-7、 图 3-8 和 图 3-9。 
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(2) Help Contents 
TP Search 
Dynamic Help 


Key Assist... Ctrl--Shift--L 
Tips and Tricks... 

Cheat Sheets... 

Check for Updates 

Install New Software... 

Eclipse Marketplace... 





About Eclipse 


图 3-7  Help-Install New Software... 


j? Install m | E) jm Sn 


Available Software 


Select a site or enter the location of a site. 





EID ype or select a site 





Find more software by working with the "Available Software Sites" preferences. 


























type filter text 








Name Version 
[7] (2) There is no site selected. 








图 3-8 Add... 


1 Add Repository 


Mame: Chrome Developer 





Ges 








[3-9 Add Repository 


然后 在 Work with 后 面 的 组 合 框 中 选择 刚刚 添加 的 Chrome Developer， 等 竺 片刻 ， 在 列表 
中 选中 Google Chrome Developer Tools， 然 后 点 击 Next， 人 参见 网 3-10。 


Available Software 
Check the items that you wish to install. 


Work with: Chrome Developer - http://chromedevtools.googlecode.com/svn/upd w 
Find more software by working with the "Available Software Sites" preferences. 


type filter text 


Name 
» [v] i00 Google Chrome Developer Tools 
b [7] 8) Google Chrome Developer Tools (Advanced) 


* nn LR 
Stem seles 


Details 


[4] Show only the latest versions of available software [T] Hide items that are already installed 
[V] Group items by category What is already installed? 

Show only software applicable to target environment 

[7] Contact all update sites during install to find required software 





[43-10 | Google Chrome Developer Tools 


这 时 Eclipse 会 计算 出 所 需 安装 的 包 和 依赖 ， 点 击 Next， 人 参见 网 3-11。 


Install Details 
Review the items to be installed. 


Name Version Id 
最 ChromeDevTools SDK WIP Backends 0.1.4.2011121302.. org.chromium.sdk wipbackends feature... 
G Chromium JavaScript Debugger Bridge to JSDT 0.3.2.2011121302.. org.chromium.debug jsdtbridge featur... 
G Chromium JavaScript Remote Debugger 0.3.2.2011121302.. org.chromium.debug.feature.group 





图 3-11 ”计算 依赖 
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阅读 License， 选 取 I accept the terms of the license agreements, ;ZihiNext, 43-12. 


Licenses must be reviewed and accepted before the software can be installed. 





Licenses: License text: 
Copyright (c) 2009 The Chromium Authors. All rights reserved. 
Copyright (c) 2010 The Chromium Authors. All rights reserved. 
Copyright (c) 2011 The Chromium Authors. All rights reserved. 





Copyright (c) 2009 The Chromium Authors. All rights 
reserved. 


^ 


Redistribution and use in source and binary forms, 
with or without modification,are permitted provided 
that the following conditions are met: 














[43-12 License 


接 下 来 Eclipse SFR KR, WSA, Z5 LEI3-13. 


$9) Installing us x 


o Installing Software 





Preparing to commit the provisioning operation- 


Always run in background 





图 3-13 ”安装 过 程 


dC E AR Eclipse 会 提示 重新 局 动 以 应 用 更 新 ， 点 击 Restart Now, V8 调试 工具 就 安 
装 完 成 了 了 ， 参 见 图 3-14。 


You will need to restart Eclipse for the installation changes to take effect. You 
may try to apply the changes without restarting, but this may cause errors. 





[3-14 Restart Now 
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2. 使 用 Eclipse 调试 Node.js 程序 

用 Eclipse 打开 一 个 Node.js 代码 ， 选 择 Debug perspective 进 入 调试 视图 ， 如 图 3-1$ 所 示 。 
点 击 工具 栏 中 Debug 图 标 右边 的 向 下 三 角形 ,选择 Debug Configurations... (参见 网 3-16 )。 在 
配置 窗口 的 左 侧 找到 Standalone V8 YM， 点 击 左上 和 角 的 New 图 标 ， 会 产生 一 个 新 的 配置 。 在 
配置 中 填写 好 Name， 如 NodeDebug， 以 及 Host 和 Port。 点 击 Apply 应 用 配置 ， 参见 图 3-17。 








jə Debug - DAWnodevsourcesvdebugjs - Eclipse 
File Edit Source Refactor Mavigate Search Project Run Window Help 


ri-HgàÀA:*-0-QqQ-is- dT Tt 
($$ Debug 3^ 4 Servers| — 20 J- Variables 3 ~ Se Breakpoints | t 


var a = 1; 
var b = 'world'; 
^war c = function (x) { 
console.log('hello ' + x + a); 


n 
c(b); 


| Writable | Smart Insert 1:11 





[43-15 Debug perspective 


evsourcesXdebug.js - Eclipse — ` o T 


» Refactor Navigate Search Project Run 


) :3*-0-Q- &$- 4 


(no launch history) 


Debug Configurations... 





Organize Favorites... 





[43-16 Debug Configurations... 
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Bean OO O 


Create, manage, and run configurations 














type filter text 





(P Chromium JavaScrig 
A HTTP Preview 

Java Applet 

3] Java Application 
T, Remote Java Applic 
$ Remote JavaScript 


Vj Rhino JavaScript 
Cy Standalone V8 VM 








ld ^ | i Name: NodeDebug 





localhost 
Port: 
5858 
Show debugger network communication console 





Breakpoint sync on launch 

(9; Merge local and remote breakpoints 
( Reset breakpoints on remote 

© None 


图 3-17 配置 Standalone V8 VM 


接 下 来 ， 通 过 node --debug-brk-5858 debug.js 命令 启动 要 调试 脚本 的 调试 服 
务 器 ， 然 后 在 Eclipse 的 工具 栏 中 点 击 调试 按钮 ， 即 可 启动 调试 ， 如 图 3-18 所 示 。 


Project 





[P-EQRI*S-0O-Q-idf-ili--t Oro iiw 5 (E Debug) 





$ Debug 23 « Ab Serers| c OP 11 E t| 3. 2e m | EY T oO) sari | ints Hpo 
E NodeDebug [Standalone V8 VM] 
af Remote "node v0.6.9" embedding V8 3.6.6.19 Scope 





a JavaScript Thread (Suspended) 


Module.load [module.js:351] 


Value 


[Object] (id-1) 


(anonymous function) [DAnodeWsourcesydebug.js:6] ; [Function] (id=6) 
Module. compile [module.js:444] [Object] (id=7) 
Module. extensions..js [module.js:462] [Object] (id=1) 


[Function] (id=15) 


Module. load [module.js:310] 
Module.runMain [module .js:482] 
startup.processNextTick process. tickCallback [node .js:192] 








9 (function (exports, require, module, _ filename, _ dirname) { var a = 1; 
var b - 'world'; 
var c = function (x) { 
console.log('hello ' + x + a); 


i 
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接 下 来 你 就 可 以 随心 所 欲 地 使 用 Eclipse 这 个 强大 的 IDE 来 调试 Node.js 脚本 了 。 如 果 
你 对 Eclipse 比较 熟悉 ， 你 会 惊 豆 地 发 现 Eclipse 的 所 有 单 步调 试 、 断 点 、 监 视 功 能 均 可 以 非 
常 方便 地 使 用 。 


3.4.4 使 用 node-inspector 调试 Node.js 


大 部 分 基于 Node.js 的 应 用 都 是 运行 在 浏览 如 中 的 ,例如 强大 的 调试 工具 node-inspector。 
node-inspector 是 一 个 完全 基于 Node.js 的 开源 在 线 调试 工具 ， 提 供 了 强大 的 调试 功能 和 友好 
的 用 户 界面 ， 它 的 使 用 方法 十 分 简便 。 

首先 ， 使 用 npm install -g node-inspector 命令 安装 node-inspector， 然 后 在 终 
mAP node --debug-brk-5858 debug.js 命令 连接 你 要 除 错 的 脚本 的 调试 服务 六 ， 


启动 node-inspector: 








$ node-inspector 


在 浏览 器 中 打开 http://127.0.0.1:8080/debug?port=5858， 即 可 显示 出 优雅 的 Web 调试 工 
FN’ 参见 图 3-19。 


r 
























J © node T ED 








e CG fi ()127.020.1:8080/debug?port- 5858 


一 二 
YA. > 








*  * DAnodelsources\debug.js:0 $ pPlc|tt,t y Paused 
E (function (exports, require, module i i - 

var b = 'world'; 
3|var c = function (x) { 






> Watch Expressions 
Y Call Stack 





4 console.log('hello ' + x + a); {anonymous function) D:\node'sources\debug.js:2 
31 Module. compile module.js:444 


3 的 
6 c(b); 
7 |3)5; Module. extensions..js module.js:462 
Module.load module.js:351 
Module. load module.js:310 
Module.runMain module.js:482 
node.js:192 
startup.processNextTick.process. tickCallback 
Y Scope Variables 
Y Local 
. dirname: D:XnodeXsources 
. filename: D:XnodeXsourcesXdebug... 
a: 1 








b: undefined 
c: undefined 
exports: Object 
» module: Object 
> require: function require(path) í(.. 
> this: Object 
> Global 
v Breakpoints 
[V] D:node'sources|debug.js:1 
(function (exports, require, module.. 











图 3-19  node-inspector 


node-inspector 的 使 用 方法 十 分 简单 ， 和 训 览 套 脚 本 调试 工具 一 样 ， 文 持 单 步 、 断 点 、 








调用 栈 帧 查看 等 功能 。 无 论 你 以 前 有 没有 使 用 过 调试 工具 ， 和 都 可 以 在 几 分 钟 以 内 轻松 掌握 。 
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ey node-inspector 使 用 了 WebKit Web Inspector, 因 此 只 能 在 Chrome, Safari 


警告 等 WebKit 内 核 的 浏览 器 中 使 用 ， 而 不 支持 Firefox 或 Internet Explorer。 


参考 资料 
(Node Web 开 发 》 David Herron 著 ， 人 民 邮 电 出 版 社 出 版 。 


node-supervisor: https://github.com/isaacs/node-supervisor。 

“Node.js is Cancer”: http://teddziuba.com/201 1/10/node-js-1s-cancer.html 

"Straight Talk on Event Loops": http://teddziuba.com/201 1/10/straight-talk-on-event- loops. 
html, 

“nodejs 异步 之 Timer & Tick fa”: http://club.cnodejs.org/topic/Afl16442ccaelf4aa2700109b., 
“mode.js 成 也 异步 ， 败 也 异步 ， 评 node.js 的 异步 特性 ” http;//www.jiangmiao.org/blog/ 
249].html; 

“被 误解 的 Node.js”: https://www.ibm.com/developerworks/cn/web/1201 wangqf nodejs/。 
libev: http://libev.schmorp.de.; 

“深入 浅 出 Node.js ( —): YRA Node.js AJR IR HLHI”: http://www.infoq.com/cn/articles/ 
nodejs-module-mechanism, 

‘npm 中 本 地 安装 命令 行 类 型 的 模块 是 不 注册 Path 的 ”: http://blog.goddyzhao.me/post/ 


9835631010/no-direct-command-for-local-installed-command-line-modul。 





CommongJS 包 /1.0: http:/wiki.commonjs.org/wikiPackages/1.0。 

semantic Versioning 2.0.0-rc.1: http://semver.org/. 

"Symlink a package folder — npm”: http://npmjs.org/doc/link.html ; 

"Publish a package — npm”: http://npmjs.org/doc/publish.html., 

“如 何在 Node.js 中 使 用 npm 创 建 和 发 布 一 个 模块 六 http;//www.cnblogs.com/piyeyong/ 
archive/201 1/12/ 30/2308153.html。 

V8 debugger JSON based protocol: http://code.google.com/p/v8/wiki/DebuggerProtocol. 


node-inspector: https://github.com/dannycoates/node-inspector, 
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核心 模块 是 Node.js 的 心脏 ， 它 由 一 些 精 人 简 而 高 效 的 库 组 成 ， 为 Node.js 提供 了 基本 的 
API. KER, 我们 挑选 了 一 部 分 最 和 常用 的 核心 模块 加 以 详细 介绍 ， 主 要 内 容 包 括 : 

a 全 局 对 象 ; 

D 向 用 工具 ; 

a 事件 机 制 ; 

a 文件 系统 访问 ; 

D HTTP 服务 硕 与 客户 端 。 


4.1 全 局 对 象 


JavaScript 中 有 一 个 特殊 的 对 象 ， 称 为 全 局 对 象 (Global Object )， 它 及 其 所 有 属性 都 可 
以 在 程序 的 任何 地 方 访问 ， 即 全 局 变量 。 在 浏览 硕 JavaScript "P, 3H4$ window 是 全 局 对 象 ， 
而 Node.js 中 的 全 局 对 象 是 global， 所 有 全 局 变量 (除了 global 本 身 以 外 ) 都 是 global 
对 象 的 属性 。 

我 们 在 Node.js 中 能 够 直接 访问 到 对 象 通常 都 是 global 的 属性 ,如 console.process 
等 ， 下 面 逐 一 介绍 。 


4.1.1 全 局 对 象 与 全 局 变量 


global 最 根本 的 作用 是 作为 全 局 变量 的 御 主 。 按 照 ECMAScript 的 定义 ， 满足 以 下 条 
件 的 变量 是 全 局 变量 : 

O 在 最 外 层 定义 的 变量 ; 

Q 全 局 对 象 的 属性 ; 

a 隐 式 定义 的 变量 (未 定义 直接 赋值 的 变量 )。 

当 你 定义 一 个 全 局 变量 时 ， 这 个 变量 同时 也 会 成 为 全 局 对 象 的 属性 ,反之 尔 然 。 需 要 注 
意 的 是 , TE Node.js 中 你 不 可 能 在 最 外 层 定义 变量 , 因为 所 有 用 户 代 码 都 是 属于 当前 模块 的 ， 
而 模块 本 里 不 是 最 外 层 上 下 文 。 


























永远 使 用 var 定义 变量 以 避免 引入 全 局 变量 ， 因 为 全 局 变量 会 污染 
提示 命名 空间 ， 提 高 代码 的 耦合 风险 。 





4.1.2 process 


process 是 一 个 全 局 变量 ， 即 global 对 象 的 属性 。 它 用 于 描述 当前 Node.js 进程 状态 
的 对 象 ， 提 供 了 一 个 与 操作 系统 的 简单 接口 。 通 常 在 你 写本 地 命令 行程 序 的 时 候 ， 少 不 了 要 
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和 它 打 有 交道。 下 面 将 会 介绍 process 对 象 的 一 些 最 常用 的 成 员 方 法 。 
O process .argv 是 命令 行 参数 数组 , 第 一 个 元 素 是 node, 第 二 个 元 素 是 脚本 文件 名 ， 
从 第 三 个 元 素 开 始 每 个 元 素 是 一 个 运行 参数 。 








console.log(process.argv); 
将 以 上 代码 存储 为 argv.js， 通 过 以 下 命令 运行 : 


S node argv.js 1991 name=byvoid --v "Carbo Kuo" 
[ 'node', 

'/home/byvoid/argv.js', 

'1991', 

'name-byvoid', 

(--y!, 


"Carbo Euo' | 


O process.stdqout 是 标准 输出 流 , 38 36 RIEKY console.log (O0 问 标 准 输出 打印 4 
FIT, M process.stdout .write() 函数 提供 了 更 底层 的 接口 。 

L] process. stdin 是 标准 输入 流 ， 初始 时 它 是 被 暂 停 的 ， 要 想 从 标准 输入 庄 取 数据 ， 
你 必须 恢复 流 ， 并 手动 编写 流 的 事件 啊 应 函数 。 





process.stdin.resume(); 


process.stdin.on('data', function(data) { 
process.stdout.write('read from console: ' + data.toString()); 


P) 


D process .nextTick(callback) 的 功能 是 为 事件 循环 设置 一 项 任务 ，Node.js 会 在 
下 次 事件 循环 调 啊 应 时 调用 callback. 

初学 者 很 可 能 不 理解 这 个 函数 的 作用 , 有 什么 任务 不 能 在 当下 执行 完 , 需要 区 给 下 次 事 
件 循 环 啊 应 来 做 呢 ? 我 们 讨论 过 , Node.js 适合 IO 密集 型 的 应 用 , 而 不 是 计算 密集 型 的 应 用 ， 
因为 一 个 Nodejs 进程 只 有 一 个 线程 ， 因 此 在 任何 时 刻 和 都 只 有 一 个 事件 在 执行 。 如 采 这 个 事 
件 占 用 大 量 的 CPU 时 间 ， 执行 事件 循 环 中 的 下 一 个 事件 就 需要 等 待 很 人 人 ， 因 此 Node.js 的 一 
个 编程 原则 就 是 尽量 缩短 每 个 事件 的 执行 时 间 。process .nextTick() 提供 了 一 个 这 样 的 
工具 ,可 以 把 复杂 的 工作 拆散 ， 变 成 一 个 个 较 小 的 事件 。 




















function doSomething(args, callback) { 
somethingComplicated(args); 
callback(); 

j 


doSomething(function onEnd() { 
compute(); 


IDE 
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我 们 假设 compute() 和 somethingComplicated() 是 两 个 较为 耗 时 的 孔 数 ， 以 上 
的 程序 在 调用 aosomething() 时 会 先 执行 somethingComplicated()， 然 后 立即 调用 
回调 函数 ， 在 onEna() 中 又 会 执行 compute() 。 下 面 用 process .nextTick() 改写 上 
面 的 程序 : 

function doSomething(args, callback) ( 

somethingComplicated (args); 


process.nextTick(callback); 


J 


doSomething (function onEnd() { 
compute (); 


}); 


改写 后 的 程序 会 把 上 面 耗 时 的 操作 拆 分 为 两 个 事件 , 减少 每 个 事件 的 执行 时 间 , 提高 事 
件 啊 应 速度 。 





"yi 不 要 使 用 setTimeout (fn, 0) 4&4$ process.nextTick (callback), 
警告 前 者 比 后 者 效率 要 低 得 多 。 





我 们 探讨 了 process 对 象 党 用 的 几 个 成 员 , 除 此 之 外 process 还 展示 了 process .platform、 
process.pid., process.execPath, process.memoryUsage() 等 方法 , 以 及 POSIX 
进程 信号 啊 应 机 制 。 有 兴趣 的 读者 可 以 访问 http://nodejs.org/api/process.html 了 人 解 详细 
内 容 。 


4.1.3 console 


console 用 于 提供 控制 台 标 准 输 出 ， 它 是 由 Internet Explorer 的 JScript 引擎 提供 的 调试 
工具 ， 后 来 逐渐 成 为 浏览 需 的 事实 标准 。Node.js 沿用 了 这 个 标准 ， 提 供与 习惯 行为 一 致 的 
console 对 象 ， pipe 出 流 (stdout ) 或 标准 错误 流 (stderr ) 输出 字符 。 
O console.log(): 回 标 准 输出 流 打印 字符 并 以 换行 符 结 束 。console.1og ktr T 
个 参数 ， T M iar iip 如 果 有 多 个 参数 ， 则 
以 类 似 于 C 语言 printf() 命令 的 格式 输出 。 第 一 个 参数 是 一 个 字符 串 ， 如 果 没 有 
参数 ， 只 打印 一 个 换行 。 


console.log(' Hello world'Jj; 
console.log('byvoid$diovyb'); 
console.log('byvoid$diovyb', 1991); 


结 采 为 : 
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Hello world 
byvoid$diovyb 
byvoidi1991iovyb 


D console.error(): 5 console.log() 用 法 相同 ， 只 是 回 标 准 错误 流 输 出 。 
Q console.trace(): 问 标准 错误 流 输出 当前 的 调用 栈 。 


console.trace(0); 
— A^A— + y 
运行 结果 为 : 


Trace: 

Object.«anonymous» (/home/byvoid/consoletrace.js:1:71) 
Module. compile (module.js:441:260) 

t Obgject..js (module.js:459:10) 

t Module.load (module.js:348:31) 

t Function. load (module.js:308:12) 





Array.0 (module.js:479:10) 
EventEmitter. tickCallback (node.js:192:40) 


o o o o Ņ Q Q 





4.2 常用 工具 util 


util 是 一 个 Nodejs 核心 模块 ， 提 供 常 用 函数 的 集合 ， 用 于 弥补 核心 JavaScript 的 功能 
过 于 精简 的 不 足 。 


4.2.1 util.inherits 


util.inheribLs(constructor, superConstructor) 是 一 个 实现 对 象 间 原型 继承 
的 图 数 。JavaScript 的 面 呵 对 象 特性 是 基于 原型 的 ， 与 第 见 的 基于 类 的 不 同 。JavaScript 没有 
提供 对 象 继 承 的 语言 级 别 特性 , 而 是 通过 原型 复制 来 实现 的 , 具体 细节 我 们 在 附录 A 中 讨论 ， 
在 这 里 我 们 只 介绍 util.inherits 的 用 法 ， 示 例如 下 : 











var util = require('util'); 
function Base() { 
this.name - 'base'; 


this.base - 1991; 


this.sayHello - function() ( 
console.log('Hello ' + this.name); 
Jg 
j 
Base.prototype.showName = function() { 


console.log(this.name); 
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function Sub() ( 
this.name = 'sub'; 


util.inherits(Sub, Base); 


var objBase - new Base(); 
objBase.showName(); 
objBase.sayHello(); 
console.log(objBase); 


var objSub - new Sub(); 
objSub.showName(); 
//objSub.sayHello(); 
console.log(objSub); 


我 们 定义 了 一 个 基础 对 和 象 Base 和 一 个 继承 目 Base 的 Sub, Base 有 三 个 在 构造 晒 数 
内 定义 的 属性 和 一 个 原型 中 定义 的 函数 ， 通 过 util.inherits 实现 继承 。 运 行 结果 如 下 : 


base 

Hello base 

( name: 'base', base: 1991, sayHello: [Function] } 
sub 

{ name: 'sub' } 


注意 ，Sub 仅仅 继承 了 Base 在 原型 中 定义 的 函数 ， 而 构造 函数 内 部 创造 的 base JE 
性 和 sayHello AARIA YK Sub 继承 。 同 时 ， 在 原型 中 定义 的 属性 不 会 被 console.log fF 
为 对 象 的 属性 输出 。 如 采 我 们 去 挥 objsub .sayHello(); 这 行 的 注释 ， 将 会 看 到 : 


node.js:201 
throw e; // process.nextTick error, or 'error' event on first tick 
TypeError: Object £Z«Sub» has no method 'sayHello' 
at Object.«anonymous» (/home/byvoid/utilinherits.js:29:8) 
Module. compile (module.js:441:260) 
Object..js (module.js:459:10) 
Module.load (module.js:348:31) 
Function. load (module.js:308:12) 
Array.0 (module.js:479:10) 
EventEmitter. tickCallback (node.js:192:40) 





cr cr ct ctf cf vcf rt 


uo o y 9 9 9 


4.2.2 util.inspect 


util.inspect (object, [showHidden], [depth], [colors]) 是 一 个 将 任意 对 象 转换 


为 字符 串 的 方法 , 通 肖 用 于 调试 和 错误 输出 。 它 至 少 接受 一 个 参数 object, 即 要 转换 的 对 象 。 
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showHidden 是 一 个 可 选 参数 ， 如 果 值 为 true， 将 会 输出 更 多 隐藏 信息 。 

depth 表示 最 大 递归 的 层 数 ， 如 果 对 象 很 复杂 ， 你 可 以 指定 层 数 以 控制 输出 信息 的 多 
少 。 如 果 不 指 定 depth， 默 认 会 递归 2 层 ， 指 定 为 null 表示 将 不 限 递归 层 数 完整 遍历 对 象 。 

如 果 color 值 为 true， 输 出 格式 将 会 以 ANSI 颜色 编码 ， 通 常用 于 在 终端 显示 更 漂亮 
的 效果 。 

特别 要 指出 的 是 ，util.inspect 并 不 会 简单 地 直接 把 对 象 转换 为 字符 串 ， 即 使 该 对 
象 定 义 了 tostring 方法 也 不 会 调用 。 











var util = require('util'); 


function Person() { 
this.name = 'byvoid'; 


this.toString = function() { 





return this.name; 
ji 
} 


var obj = new Person(); 


console.log(util.inspect(obj)); 
console.log(util.inspect(obj, true)); 


IST RE: 


( name: 'byvoid', toString: [Function] } 
{ toString: 
{ [Function] 
[prototype]: { [constructor]: [Circular] 43 
[caller]: null, 
[length]: 0, 
[name]: '' 
[arguments]: null }, 


name: 'byvoid' } 


除了 以 上 我 们 介绍 的 几 个 函数 之 外 ,util 还 提供 了 util. isArray().util.isRegExp()., 
util.isDate(), util.isError() 四 个 类 型 测试 工具 ， 以 及 util.format()., util. 
debug () 等 工具 。 有 兴趣 的 读者 可 以 访问 http://nodejs.org/api/util.html 了 解 详细 内 容 。 


4.3 事件 驱动 events 


events 是 Node.js 最 重要 的 模块 ， 没 有 “之 一 "， 原 因 是 Node.js KART ERF 
的 ， 而 它 提 供 了 唯一 的 接口 ， 所 以 堪 称 Node.js 事件 编程 的 基石 。events 模块 不 仪 用 于 用 
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PAIRI- Node.js 下 层 事 件 循环 的 交互 ， 还 几乎 被 所 有 的 模块 依赖 。 
4.3.1 事件 发 射 器 


events 模块 只 提供 了 一 个 对 象 : events.EventEmitter, EventEmitter 的 核心 就 
是 事件 发 射 与 事件 监听 器 功能 的 封装 。 Event Emitter 的 每 个 事件 由 一 个 事件 名 和 若干 个 参 
数组 成 , 事件 名 是 一 个 字符 串 ， 通常 表达 一 定 的 语义 。 对 于 每 个 事件 ，EventEmitter 文 持 
右 干 个 事件 监听 各 。 当 事件 发 射 时 ,注册 到 这 个 事件 的 事件 监听 剖 被 依次 调用 ,事件 参数 作 
为 回调 函数 参数 传递 。 

让 我 们 以 下 面 的 例子 解释 这 个 过 程 : 














var events = require('events'); 
var emitter - new events.EventEmitter(); 


emitter.on('someEvent', function(arg1l, arg2) ( 
console.log('listenerl1', arg1, arg2); 


I3 


emitter.on('someEvent', function(arg1l, arg2) ( 
console.log('listener2', argl, arg2); 


33 


emitter.emit('someEvent', 'byvoid', 1991); 
mri mr E 
运行 的 结果 是 : 


listenerl byvoid 1991 
listener2 byvoid 1991 


以 上 例子 中 ，emitter 为 事件 someEvent EW f MDEE Ar, ARN T 
someEvent Fo ÍTR P n] LUE SUPSAT SAPE Ur s [nd Je] PDC cJ 813 o 

这 就 是 Event Emitter 最 简单 的 用 法 。 接 下 来 我 们 介绍 一 下 Event Emitter 第 用 的 API。 

O EventEmitter.on(event, listener) 为 指定 事件 注册 一 个 监听 需 ， 接 受 一 个 字 
IFE event 和 一 个 回调 果 数 listener。 

O EventEmitter.emit(event, [argi], [arg2], [...1) 发射 event 事件 ， 传 
递 右 干 可 选 参 数 到 事件 监听 带 的 参数 表 。 

O EventEmitter.once(event, listener) 为 指定 事件 注册 一 个 单 次 监听 大 ， 即 
监听 融 最 多 只 会 触发 一 次 ， 触 发 后 立刻 解除 该 监听 痪 。 

O EventEmitter.removeListener(event, listener) 移 除 指定 事件 的 某 个 监听 
fr, listener 必须 是 该 事件 已 经 注册 过 的 监 昕 各。 
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O EventEmitter.removeAllListeners([event]) 移 除 上 所 有 事件 的 所 有 监听 天 ， 
如 有 果 指 定 event, ， 则 移 除 指定 事件 的 所 有 监听 冀 。 
更 详细 的 API 文档 参见 http://nodejs.org/api/events.html。 


4.3.2 error 事件 


EventEmitter 定义 了 一 个 特殊 的 事件 error, 它 包 含 了 “错误 ”的 语义 ,我 们 在 过 到 
异常 的 时 候 通 常会 发 里 error 事件 。 当 error 被 发 射 时 ，EventEmitter 规定 如 果 没 有 啊 
应 的 监听 需 , Node.js 会 把 它 当 作 异 常 , 退出 程序 并 打印 调用 栈 。 我 们 一 般 要 为 会 发 射 error 
事件 的 对 象 设 置 监 听 器 ， 避 免 遇 到 错误 后 整个 程序 朋 溃 。 例 如 : 


var events = require('events'); 








var emitter - new events.EventEmitter(); 





emitter.emit('error'); 
y— 人 一 一 人 = `O 
运行 时 会 显示 以 下 错误 : 
node.js:201 
throw e; // process.nextTick error, or 'error' event on first tick 
Error: Uncaught, unspecified 'error' event. 
EventEmitter.emit (events.jsg:50:15) 


Object.«anonymous» (/home/byvoid/error.js:5:9) 


cet cr ct 


Module. compile (module.js:441:260) 
Object..js (module.js:459:10) 

Module.load (module.js:348:31) 

Function. load (module.js:308:12) 

Arrav.0 (module.Js:479:10) 

EventEmitter. tickCallback (node.js:192:40) 








o o mo 9 9 9% o 


Ch xL EF -i a 


4.3.3 ”继承 EventEmitter 


大 多 数 时 候 我 们 不 会 直接 使 用 EventEmitter， 而 是 在 对 象 中 继承 它 。 包 括 fs net, 
http 在 内 的 ， 只 要 是 文 持 事件 响应 的 核心 模块 都 是 EventEmitter 的 子 类 。 

为 什么 要 这 样 做 呢 ? 原因 有 两 点 。 首 先 ， 具 有 某 个 实体 功能 的 对 象 实现 事件 符合 语义 ， 
事件 的 监听 和 发 射 应 该 是 一 个 对 象 的 方法 。 其 次 JavaScript 的 对 象 机 制 是 基于 原型 的 ， 文 持 
部 分 多 重 继承 ， 继 承 EventEmitter 不 会 打 乱 对 象 原 有 的 继承 关系 。 


44 文件 系统 ts 
fs 模块 是 文件 操作 的 封装 ， 它 提供 了 文件 的 读 取 、 写 人 、 和 更名、 删除、 遍历 目录 、 链 
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接 等 POSIX 文件 系统 操作 。 与 其 他 模块 不 同 的 是 ，fs 模块 中 所 有 的 操作 都 提供 了 异步 的 和 
同步 的 两 个 版 本 ,例如 读 取 文件 内 容 的 函数 有 异步 的 fs.readqFile() 和 同步 的 
fs .readFileSync()。 我 们 以 几 个 也 数 为 代表 ,介绍 fs 第 用 的 功能 ， 并 列 出 fs 所 有 因数 
的 定义 和 功能 。 


4.4.1 fs.readFile 


fs.readFile(filename, [encoding], [callback (err,data)]) 是 最 简单 的 读 取 
文件 的 图 数 。 它 接受 一 个 必 选 参数 filename, 表示 要 读 取 的 文件 名 。 第 二 个 参数 encoding 
EE, KRF o callback 是 回调 也 数 ， 用 于 接收 文件 的 内 容 。 如 有 果 不 指 
定 encoding, lll callback 就 是 第 二 个 参数 ,回调 隐 数 提供 两 个 参数 err Fl data, err x 
示 有 没有 错误 发 生 ，data 是 文件 内 容 。 如 果 指 定 了 encoding，data 是 一 个 解析 后 的 字符 
$, F] data 将 会 是 以 Buffer 形式 表示 的 二 进 制 数 据 。 

例如 以 下 程序 ， 我 们 从 content.txt 中 读 取 数据 ， 但 不 指定 编码 : 


var fs = require('fs'); 





fs.readFile('content.txt', function(err, data) { 
if (err) { 
console.error(err); 
j else ( 
console.log(data); 
j 
)1 


假设 content.txt 中 的 内 容 是 UTF-8 编码 的 Text 文本 文件 示例 ， 运 行 结果 如 下 : 








«Buffer 54 65 78 74 20 e6 96 87 e6 9c ac eo 96 87 e4 bb b6 e7 a4 ba e4 be 8b» 


这 个 程序 以 二 进 制 的 模式 读 取 了 文件 的 内 容 ，gdata 的 值 是 Buffer 对 象 。 如 果 我 们 给 
fs.readFile 的 encoding 指定 编码 : 


var fs = require('fs'); 


fs.readFile('content.txt', 'utf-8', function(err, data) { 
if (err) 1 
console.error(err); 
} else ( 
console.log(data); 
j 
JI? 


那么 运行 结果 则 是 : 


Text 文本 文件 示例 
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当 读 取 文件 出 现 错误 时 ，ert 将 会 是 Error XZ. W content.txt 不 存在 ， 运 行 前 面 
的 代码 则 会 出 现 以 下 结 


{ [Error: ENOENT, no such file or directory 'content.txt'] errno: 34, code: 'ENOENT', 
path: 'content.txt' } 





Node.js 的 异步 编程 接口 习惯 是 以 函数 的 最 后 一 个 参数 为 回调 函数 ， 通 
We 常 一 个 函数 只 有 一 个 回调 函数 。 回 调 函 数 是 实际 参数 中 第 一 个 是 err， 其 
余 的 参数 是 其 他 返回 的 内 容 。 如 果 没 有 发 生 错 误 ，err 的 值 会 是 null 或 
undefined。 如 果 有 错误 发 生 ，err 通常 是 Error d $983 X4], 


4.4.2 fs.readFileSync 





fs.readFileSync(filename, [encoding]) 是 fs.readFile 同步 的 版 本 。 它 接受 
的 参数 和 fs .readFile 相同 ， 而 读 取 到 的 文件 内 容 会 以 函数 返回 值 的 形式 返回 。 如 果 有 人 蚀 
误 发 生 ，fs 将 会 抛 出 异 帝 ， 你 需要 使 用 try 和 catch 捕捉 并 人 处理 异 常 。 








e. 与 同步 IO 函数 不 同 ，Node.js 中 异步 函数 大 多 没有 返回 值 。 
提示 


4.4.3 fs.open 


fs.open(path, flags, [mode], [callback(err, fd)])JÉé POSIX open PR 
BUE. 5 C 语言 标准 库 中 的 fopen 函数 类 似 。 它 接受 两 个 必 选 参数 ，patn 为 文件 的 路 径 ， 
flags 可 以 是 以 下 值 。 

Qr : 以 谈 取 模 式 打开 文件 。 

O re: 以 恋 写 模式 打开 文件 。 

Ow : 以 写 入 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 

O we: 以 读 写 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 

Qa : 以 追加 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 。 

O ar: 以 读 取 追加 模式 打开 文件 ， 如 采 文 件 不 存在 则 创建 。 

mode 参数 用 于 创建 文件 时 给 文件 指定 权限 ， 默 认 是 0666"。 回 调 函 数 将 会 传递 一 个 文 
件 描述 符 £a” 








(D 文件 权限 指 的 是 POSIX 操作 系统 中 对 文件 读 取 和 访问 权限 的 规范 ， 通 常用 一 个 八进制 数 来 表示 。 例 如 0754 K 
示 文 件 所 有 者 的 权限 是 7 ( 读 、 写 、 执 行 )， 同 组 的 用 户 权限 是 5 ( 恋 、 执 行 )， 其 他 用 户 的 权限 是 4 CE), 
写成 字符 表示 就 是 -rwxr-xr--。 

Gg) 文 件 描 述 符 是 一 个 非 负 整数 ， 表 示 操 作 系统 内 核 为 当前 进程 所 维护 的 打开 文件 的 记录 表 索 引 。 
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4.4.4 fs.read 


fs.read(fd, buffer, offset, length, position, [callback(err, bytesRead, 
buffer) ] ) Æ POSIX read KAJE , 相 比 £s .readFile 提供 了 更 底层 的 接口 。 fs.read 
的 功能 是 从 指定 的 文件 摘 述 符 £a 中 读 取 数据 并 写 和 人 buffer 指 回 的 缓冲 区 对 象 。offset 是 
buffer WHA MEE. length 是 要 从 文件 中 读 取 的 子 市 数 。position 是 文件 谈 取 的 起 始 
位 置 ， 如 果 position 的 值 为 nul1， 则 会 从 当前 文件 指针 的 位 置 谈 取 。 回 调 冰 数 传递 
bytesRead FI buffer, TAJR RERIT TAR MKX 

以 下 是 一 个 使 用 fs.open 和 fs.read 的 示例 。 





var fs = require('fs'); 


fs.open('content.txt', 'r', function(err, fd) { 
if (err) ( 
console.error(err); 


return; 


var buf = new Buffter(8); 
fs.read(fd, buf, 0, 8, null, function(err, bytesRead, buffer) { 
if (err) { 
console.error(err); 
return; 


J 


console.log('bytesRead: ' + bytesRead); 
console.log(buffer); 
j) 
lii 


运行 结果 则 是 : 


bytesRead: 8 
<Buffer 54 65 78 74 20 e6 95 87> 


一 般 来 说 ， 除 非 必 要 ， 和 否则 不 要 使 用 这 种 方式 读 取 文件 ， 因 为 它 要 求 你 手动 管理 缓冲 区 
和 文件 指针 ， 尤 其 是 在 你 不 知道 文件 大 小 的 时 候 ， 这 将 会 是 一 件 很 腑 烦 的 事情 。 
表 4-1 列 出 了 fs 所 有 图 数 的 定义 和 功能 。 
表 4-1 fs 模块 函数 表 
X 能 异步 函数 同步 函数 


打开 文件 fs.open (path, flags, [mode], [callback (err, fs.openSync(path, flags, [mode] ) 
fd) ] ) 











关闭 文件 fs.close(fd, [callback (err)]) fs.closeSync(fd) 


I) 能 
ERE PF 
述 符 ) 

写 人 文件 (文件 描 
述 符 ) 
读 取 文件 内 容 





写 人 文件 内 容 


删除 文件 
创建 目录 
删除 目录 
读 取 目录 
获取 真实 路 径 





更 多 

截断 
更 改 所 有 权 

更 改 所 有 权 ( 文件 
描述 符 ) 

更 改 所 有 权 ( 不 解 
析 符 号 链接 ) 

更 改 权限 

更 改 权限 (文件 描 
述 符 ) 

更 改 权 限 ( 不 解析 
符号 链接 ) 

获取 文件 信息 
获取 文件 信息 ( 文 
件 描 述 符 ) 

获取 文件 信息 ( 不 
解析 符号 链接 ) 
创建 硬 链 接 
创建 符号 链接 








读 取 链接 
修改 文件 时 间 截 
修改 文件 时 间 截 


(文件 描述 符 ) 
同步 磁盘 缓存 


异步 函数 
fs.read(fd,buffer,offset,length,position, 


[callback(err, bytesRead, buffer)]) 


fs.write(fd,buffer,offset,length,position, 


[callback(err, bytesWritten, buffer)]) 


fs.readFile(filename,[encoding],[callba 


Ck(err, data)l) 


fs.writeFile(filename, 
[callback(err)]) 


data, [encoding], 


fs.unlink(path, [callback(err)]) 


fs.mkdir(path, [mode], [callback(err)]) 


fs.rmdir(path, [callback(err)]) 


fs.readdir(path, [callback(err, files)]) 


fs.realpathípath, [callback (err, 


resolvedPath)]) 





fs.rename(pathl1, path2, [callback(err)]) 


fs.truncate(fd, len, [callback(err)]) 


fs.chown(path, uid, gid, [callback(err)]) 


fs.fchown (fd, uid, gid, [callback(err)]) 


fs.lchown(path, uid, gid, [callback(err)]) 


fs.chmod(path, mode, [callback(err)]) 
fs.fchmod(fd, mode, [callback(err)]) 


fs.lchmod(path, mode, [callback(err)]) 


fs.stat (path, [callback(err, stats)]l) 
fs.fstat (fd, [callback (err, stats)]) 
fs.lstat (path, [callback(err, stats)]) 


fs.link(srcpath, dstpath, [callback(err)]) 


fs.symlink(linkdata, 
[callback(err)]) 


path, [typel], 


fs.readlink(path, [callback(err, 


linkString)]) 

fs.utimes (path, atime, mtime, [callback 
(err. 

fs.futimes(fd, atime, mtime, [callback 


(err) 


fs.fsync(fd, [callback(err)]) 
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(2) 
同步 函数 
fs.readSync(fd, buffer, offset, 
length, position) 
fs.writeSync(fd, buffer, offset, 


length, position) 


fs.readFileSync(filename, 








[encoding]) 
fs.writeFileSync(filename, data, 
[encoding]) 

fs.unlinkSync (path) 
fs.mkdirSync(path, [mode]) 
fs.rmdirSync (path) 
fs.readdirSync(path) 
fs.realpathSync (path) 
Is.renameSyvnce(pathl, path2) 
fs.truncateSync(fd, len) 
fs.chownSync (path, uid, gid) 
fs.fchownSync (fd, uid, gid) 
fs.lchownSync(path, uid, gid) 


fs.chmodSync(path, mode) 
fs.fchmodSync(fd, mode) 


fs.lchmodSync(path, mode) 


fs.statSync (path) 
fs.fstatSync (fd) 


fs.lstatSync(path) 


fs.linkSyncísrcpath, dstpath) 


fs.symlinkSync(linkdata, 
[typel 


path, 
fs.readlinkSync (path) 
fs.utimesSync(path, atime, mtime) 
mtime) 


fs.futimesSync(fd, atime, 


fs.fsyncSync (fd) 
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45 HTTP 服务 器 与 客户 端 


Node.js 标准 库 提供 了 http 模块 ， 其 中 封装 了 一 个 高 效 的 HTTP 服务 器 和 一 个 简易 的 
HTTP F ino http .Server 是 一 个 基于 事件 的 HTTP 服 务 太 , 它 的 核心 由 Node.js 下 层 C++ 
部 分 实现 ， 而 接口 由 JavaScript 封装 ， 兼顾 了 高 性 能 与 价 易 性 。http.request 则 是 一 个 
HTTP 客户 端 工 具 ， 用 于 向 HTTP 服务 紫 发 起 请 求 ， 例 如 实现 Pingback 或 者 内 容 抓 取 。 





4.5.1 HTTP 服务 器 


http.Server 是 http 模块 中 的 HTTP 服务 硕 对 象 ， 用 Node.js 做 的 所 有 基于 HTTP 协 
议 的 系统 ， 如 网 站 、 社 交 应 用 其 至 代理 服务 各 ， 痢 是 基于 http.Server 实现 的 。 它 提供 了 
一 套 封装 级 别 很 低 的 API, 仪 仅 是 流 控 制 和 简单 的 消息 解析 ， 所 有 的 高 层 功 能 都 要 通过 它 的 
接口 来 实现 。 

我 们 在 3.1.3 节 中 使 用 http 实现 了 一 个 服务 器 : 








//app.js 
var http = require('http'); 
http.createServer (function(req, res) { 


res.writeHead(200, {'Content-Type': 'text/html'}); 
res.write('«hl»Node.js«/h1»'); 





res,end('«p»Hello World«/p»!); 
)).listen(3000); 


console.log("HTTP server is listening at port 3000."); 


这 上 段 代 码 中 ，http.createServer 创建 了 一 个 http.Server WX, T4R—^ PSA 
作为 HTTP 请 求 处 理 函 数 。 这 个 冰 数 接受 两 个 参数 ， 分 别 是 请 求 对 象 ( req ) TR AR 
( res ). 在 函数 体内 ，res 显 式 地 写 回 了 响应 代码 200 (表示 请 求 成 功 )， 指 定 啊 应 头 为 
'Content-Type': 'text/html'， 然 后 写 信 啊 应 体 '<h1>Node.js</h1>', 通过 res.end 
结束 并 发 送 。 最 后 该 实例 还 调用 了 listen 函数 ， 启 动 服务 器 并 监听 3000 端口 。 

1. http. Server 的 事件 

http.Server 是 一 个 基于 事件 的 HTTP Riar, PARERE RNI BOSE, 
开发 者 只 需要 对 它 的 事件 编写 啊 应 函数 即 可 实现 HTTP. 服务 兹 的 所 有 功能 。 它 继承 日 
EventEmitter， 提 供 了 以 下 几 个 事件 。 











(D Pingback 是 博客 系统 中 用 来 通知 文章 被 他 人 引用 的 一 种 手段 ， 例 如 WordPress 会 自动 解析 文章 中 的 链接 ， 发 送 
Pingback 以 告知 链接 被 引用 。 
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O request: 当 客 户 端 请 求 到 来 时 ， 该 事件 被 触发 ， 提 供 两 个 参数 req 和 res， 分 别 是 

http.ServerRequest 和 http.ServerResponse 的 实例 ， 表 示 请 求 和 啊 应 信息 。 

O connection: 当 TOP 连接 建立 时 ,该 事件 被 触发 ， 提 供 一 个 参数 socket, X 

net .Socket 的 实例 。connection 事件 的 粒度 要 大 于 request, DO P mE 
Keep-Alive 模式 下 可 能 会 在 同一 个 连接 内 发 送 多 次 请 求 。 

D close: 当 服 务 硕 关闭 时 ， 该 事件 被 甬 上 发。 注意 不 是 在 用 户 连 接 断 开 时 。 

除 此 之 外 还 有 checkContinue. upgrade, clientError 事件 ， 通常 我 们 不 需要 关 
心 ， 只 有 在 实现 复杂 的 HTTP 服务 器 的 时 候 才 会 用 到 。 

在 这 些 事 件 中 ， 最 第 用 的 就 是 request T, AIEE http 提供 了 一 个 捷径 : 
http.createServer([requestListener]) ， 功 能 是 创建 一 个 HTTP 服务 问 并 将 
requestListener 作为 request 事件 的 监听 函数 ， 这 也 是 我 们 前 面 例子 中 使 用 的 方法 。 
事实 上 它 显 式 的 实现 方法 是 : 

















//httpserver.js 


var http - require('http'); 


var server - new http.Server(); 
server.on('request', function(reg, res) ( 
res.writeHead(200, í'Content-Type': 'text/html']); 


res.write('«hl»Node.js«/h1»'); 
res.end('«p»Hello World«/p»'); 
IF 


server.listen(3000); 


console.log("HTTP server is listening at port 3000."); 


2.http.ServerRequest 
http.ServerRequest Æ HTTP 请 求 的 信息 ， 是 后 端 开发 者 最 关注 的 内 容 。 它 一 般 由 
http.Server 的 request 事件 发 送 ， 作 为 第 一 个 参数 传递 ， 通 稼 简称 request 或 req. 
ServerRequest 提供 一 些 属性 ， 表 4-2 中 列 出 了 这 些 属性 。 
HTTP 请 求 一 般 可 以 分 为 两 部 分 : RA (Request Header ) 和 请 求 体 (Requset Body )。 
以 上 内 容 由 于 长 度 较 短 都 可 以 在 请 求 头 解析 完成 后 立即 读 取 。 而 请 求 体 可 能 相对 较 长 ， 
需要 一 定 的 时 间 传 输 ， 因 此 ht LD.oerverReguest.c 提供 了 以 下 3 个 事件 用 于 控制 请 求 体 
传输 。 
O data: 当 请 求 体 数 据 到 来 时 ， 该 事件 被 触发 。 该 事件 提供 一 个 参数 chunk, Ri 
收 到 的 数据 。 如 果 该 事件 没有 人 补 监听， 那么 请 求 体 将 会 被 抛弃 。 该 事件 可 能 会 被 调 
用 多 次 。 
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O end: 当 请 求 体 数 据 传输 完成 时 ， 该 事件 被 触发 ， 此 后 将 不 会 再 有 数据 到 来 。 
O close: 用 户 当 前 请 求 结束 时 ， 该 事件 被 触发 。 不 同 于 enda， 如 采用 户 强 制 终 止 了 
传输 ， 也 还 是 调用 close。 


表 4-2 ServerRequest 的 属性 




















名 称 £ X 
complete 客户 端 请 求 是 否 已 经 发 送 完成 
httpversion HTTP 协议 版 本 ， 通 常 是 1.0 2X 1.1 
method HTTP 请 求 方法 ， 如 GET. POST, PUT, DELETE 等 
url 原始 的 请 求 路 径 ， 例 如 /static/image/x.jpg 9X /user?name-byvoid 
headers HTTP 请 求 头 
trailers HTTP 请 求 尾 ( 不 常见 ) 
connection 当前 HTTP 连接 套 接 字 ， 为 net .Socket 的 实例 
Socket connection 属性 的 别名 
client client 属性 的 别名 


3. 获取 GET 请 求 内 容 

注意 ，http.ServerRequest 提供 的 属性 中 没有 类 似 于 PHP 语言 中 的 $ GET 或 
$ PosT 的 属性 ， 那 我 们 如 何 接受 客户 问 的 表单 请 求 呢 ? 由 于 GET 请 求 直接 被 租 人 在 路 径 
中 ,URL 是 完整 的 请 求 路 径 ,包括 了 ? 后 面 的 部 分 ,因此 你 可 以 手动 解析 后 面 的 内 容 作 为 GET 
请 求 的 参数 。 Node.js 的 url 模块 中 的 parse 师 数 提供 了 这 个 功能 ， 例 如 : 








//httpserverrequestget.js 





var http - require('http'); 
var url - require('url'); 


var util - require('util'); 





http.createServer(function(regd, res) { 
res.writeHead(200, ['Content-Type': 'text/plain')]); 
res.end(util.inspect(url.parse(req.url, true))); 
)).1isten(3000); 


EN ssp UII] http://127.0.0.1:3000/user?name-byvoid&email-byvoid(àbyvoid.com, FÈ 
ATE Æ STU] EAER EAZ 
{ search: '?name=byvoid&email=byvoid@byvoid.com', 


query: { name: 'byvoid', email: 'byvoid@byvoid.com' }, 


pathname: '/user', 
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path: '/user?name-byvoid&email-zbyvoidGbyvoid.com', 
href: '/user?name-byvoid&email-byvoidG8byvoid.com' } 


通过 url.parse^, 原始 的 path 被 解析 为 一 个 对 象 , 其 中 query 就 是 我 们 所 谓 的 GET 
请 求 的 内 容 ， 而 路 径 则 是 pathname, 

4. 获取 POST 请 求 内 容 

HTTP 协议 1.1 版 本 提供 了 8 种 标准 的 请 求 方法 ， 其 中 最 和 常见 的 就 是 GET 和 POST。 相 比 
GET 请 求 把 所 有 的 内 容 编 码 到 访问 路 径 中 ，POST 请 求 的 内 容 全 部 都 在 请 求 体 中 。 
http.ServerRequest 并 没有 一 个 属性 内 容 为 请 求 体 ， 原因 是 等 待 请 求 体 传输 可 能 是 一 件 
耗 时 的 工作 , 璧 如 上 传 文件 。 而 很 多 时 候 我 们 可 能 并 不 需要 理会 请 求 体 的 内 容 , 恶意 的 POST 
请 求 会 大 大 消耗 服务 器 的 资源 。 所 以 Node.js 默认 是 不 会 解析 请 求 体 的 ， 当 你 需要 的 时 候 ， 
需要 手动 来 做 。 让 我 们 看 看 实现 方法 : 




















//httpserverrequestpost.js 
var http - require('http'); 
var querystring - require('querystring'); 


var util - require('util'); 


http.createServer(function(reqg, res) ( 





var post e '' 


req.on('data', function(chunk) { 
post += chunk; 


}); 


req.on('end', function() { 
post - querystring.parse(post); 
res.end(util.inspect(post)); 


does 


)) .listen (3000) ; 

EERE RA TE3S SK p P BR Cn p] 2 Pra In MEL, MEEA I —^" post 变量 ,用 
于 在 闭 包 中 和 暂 存 请 求 体 的 信息 。 通 过 rea 的 aata 事 件 监 听 函 数 , 每 当 接受 到 请 求 体 的 数据 ， 
就 累加 到 post 变量 中 。 在 ena 事件 触发 后 ， 通 过 querystring.parse 将 post 解析 为 
真正 的 POST 请 求 格 式 ， 然 后 辐 客 户 端 返回 。 

















m 不 要 在 真正 的 生产 应 用 中 使 用 上 面 这 种 简单 的 方法 来 获取 POST 请 
警告 求 ， 因 为 它 有 严重 的 效率 问题 和 安全 问题 , 这 只 是 一 个 帮助 你 理解 的 示例 。 


(D url 模块 的 说 明 参 见 http:/nodejs.org/api/url.html。 
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5. http.ServerResponse 

http.ServerResponse 是 返回 给 客户 端的 信息 ， 决 定 了 用 户 最 终 能 看 到 的 结果 。 它 
也 是 由 http.Server 的 request 事件 发 送 的 ， 作 为 第 二 个 参数 传递 ， 一 般 简 称 为 
response Hk reso 

http.ServerResponse/f — 4 HEB A KZ, FT ER EA, np pz AREE Zr 

请 求 。 

口 response.writeHead(statusCode, [headers]): 问 请 求 的 客户 端 发 送 啊 应 头 。 

statusCode 是 HTTP 状态 码 ， 如 200 (EREI )、404 (RREI) S5, headers 
一 个 类 似 关 联 数组 的 对 象 ， 表 示 啊 应 头 的 每 个 属性 。 该 函数 在 一 个 请 求 内 最 多 只 
能 调用 一 次 ， 如 采 不 调用 ， 则 会 目 动 生成 一 个 啊 应 头 。 

L] response.write(data, [encoding]l): 回 请 求 的 客户 端 发 送 啊 应 内 容 。dqata 是 
一 个 Buffer 或 字符 串 ， 表 示 要 发 送 的 内 容 。 如 采 data 是 字符 串 ， 那 么 需要 指定 
encoding 来 说 明 它 的 编码 方式 ， 上 默认 是 utf-8。 在 response.end 调用 之 前 ， 
response.write 可 以 被 多 次 调用 。 

D response.end([data], [encoding]): 结束 啊 应 ， 告 知客 户 端 所 有 发 送 已 经 完 
成 。 当 所 有 要 返回 的 内 容 发 送 完 毕 的 时 修 ， 该 函数 必须 被 调用 一 次 。 它 接受 两 个 可 
选 参 数 ， 意 义 和 response.write 相同 。 如 果 不 调用 该 函数 ， 客 户 端 将 永远 处 于 
等 待 状态 。 





























4.5.2 HTTP E Pim 





http 模块 提供 了 两 个 函数 http.request 和 http.get， 功 能 是 作为 客户 端 向 HTTP 
服务 从 发 起 请 求 。 
O http.request (options, callback) 发 起 HTTP 请 求 。 接 受 两 个 参数 , option 是 
一 个 类 似 关联 数组 的 对 象 , 表示 请 求 的 参数 , callback 是 请 求 的 回调 孙 数 option 
各 用 的 参数 如 下 所 示 。 
m host: 请 求 网 站 的 域名 或 卫 地 址 。 
m port: 请 求 网 站 的 端口 ， 默 认 80. 
m method : 请 求 方法 ， 默 认 是 GET. 
m path: 请 求 的 相对 于 根 的 路 径 ， 默 认 是 “/”。Querystring 应 该 包含 在 其 中 。 
例如 /search?query-byvoids 
m headers: 一 个 关联 数组 对 象 ， 为 请 求 头 的 内 容 。 
callback 传递 一 个 参数 ， Jjhttp.ClientResponse 的 实例 。 
http.request 返回 一 个 http.CLientReduest 的 实例 。 








` 
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下 面 是 一 个 通过 http.request 发 送 POST 请 求 的 代码 : 
//httprequest.js 


var http - require('http'); 


var querystring - require('querystring'); 


var contents = querystring.stringify(( 
name: 'byvoid', 
email: 'byvoidGbyvoid.com', 
address: 'Zijing 24, Tsinghua University', 


l22- 


var options = { 
host: 'www.byvoid.com', 
path: '/application/node/post.php', 
method: 'POST', 
headers: { 





'Content-Type': 'application/x-www-form-urlencoded', 
'Content-Length' : contents.length 
】 
H 


var req = http.request(options, function(res) { 
res.setEncoding('utf8'); 
res.on('data', function (data) ( 
console.log(data); 
r3 
r$ 


req.write(contents); 
req.endt); 


运行 后 结 朱 如 下 : 


array(3) ( 
[ "name" ] => 
string(6) "byvoid" 
["email"]=> 
string(17) "byvoid@byvoid.com" 
["address"]eses 
string(30) "Zijing 2#, Tsinghua University" 






不 要 忘 了 通过 reg.end() 结束 请 求 ， 否 则 服务 器 将 不 会 收 到 信息 。 
提示 
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O http.get(options, callback) http 模块 还 提供 了 一 个 更 加 简便 的 方法 用 于 处 
理 GET 请 求 : nttp.get。 它 是 http.request 的 简化 版 , 唯一 的 区 别 在 于 http .get 
目 动 将 请 求 方法 设 为 了 了 GET 请求， 同时 不 需要 手动 调用 req.end()。 


//httpget.js 
var http - require('http'); 


http.get(Ííhost: 'www.byvoid.com'), function(res) ( 
res.setEncoding('utf8'); 
res.on('data', function (data) { 
console.log(data); 
i): 
J)a 


1. http.ClientRequest 

http.ClientRequest 是 由 http.request 或 http.get 返回 产生 的 对 象 ， 表示 一 
个 已 经 产生 而 且 正 在 进行 中 的 HITP 请 求 。 它 提供 一 个 response $F, Bl http .recuest 
或 http.get 第 二 个 参数 指定 的 回调 函数 的 绑 定 对 象 。 我 们 也 可 以 显 式 地 绑 定 这 个 事件 的 
监听 函数 : 





//httpresponse.js 
var http - require('http'); 
var req = http.get(íhost: 'www.byvoid.com')); 


req.on('response', function(res) ( 
res.setEncoding('utf8'); 
res.on('data', function (data) { 
console.log(data); 
Iis 
}); 
http.ClientRequest 像 http.ServerResponse 一 样 也 提供 了 write 和 ena PA 
数 , 用 于 向 服务 器 发 送 请 求 体 , 通常 用 于 POST 、PUT 等 操作 。 所 有 写 结束 以 后 必须 调用 ena 
PK BI RH AS s , 否则 请 求 无 效 。 http.ClientRequest 还 提供 了 VA F R 
Q request .abort (): 终止 正在 发 送 的 请 求 。 
O request.setTimeout (timeout, [callback]) :设置 请 求 超时 时 间 , timeout 为 
毫秒 数 。 当 请 求 超时 以 后 ，callback 将 会 被 调用 。 
ICA NB request .setNoDelav([noDelay]).request.setSocketKeepAlive 
([enable], [initialDelay]) SRA, FUPRPIARB A JL Node.js 文档 。 
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2.http.ClientResponse 

http.ClientResponse = http.ServerRequest 相似 i 提供 了 三 个 事件 data, end 
和 close, 分 别 在 数据 到 达 、 传 输 结 束 和 连接 结束 时 触发 ， 其 中 data 事件 传递 一 个 参数 
chunk， 表 示 接 收 到 的 数据 。 

http.ClientResponse 也 提供 了 一 些 属性 ， 用 于 表示 请 求 的 结果 状态 ， 参 见 表 4-3。 








表 4-3 clientResponse 的 属性 





名 称 E X 
statusCode HTTP 状态 人 码 ， 如 200、404、500 
httpVersion HTTP 协议 版 本 ,通常 是 1.0 或 1.1 
headers HTTP 请 求 头 
trailers HTTP 请 求 尾 (不 常见 ) 





http.ClientResponse 还 提供 了 以 下 儿 个 特殊 的 函数 。 

口 response.setEncoding([encoding]): 设置 默认 的 编码 ， 当 data SESS 
时 ， 数 据 将 会 以 encoding 编码 。 默 认 值 是 null1， 即 不 编码 ， 以 Buffer 的 形式 存 
储 。 常 用 编码 为 utf8。 

O response.pause(): 暂 信 接收 数据 和 发 送 事 件 ， 方 便 实现 下 载 功能 。 

O response.resume(): 从 暂停 的 状态 中 恢复 。 
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CQ Node.js Manual & Documentation: http://nodejs.org/api/index.html , 

Q "Understanding process.nextTick()":http:;//howtonode.org/understanding- process- 
next-tick.; 

O “揭秘 Node.js 事 件 ” http://www.grati.org/?p-318. 
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阅读 到 这 一 童 为止， 你 已 经 学 习 了 许多 知识 ,但 还 缺乏 实战 性 的 内 容 。 本 和 草 ， 我 们 打算 
从 和 雪 开 始 用 Nodejs 实现 一 个 微 博 系统 ， 功 能 包括 路 由 控制 、 页 面 模板 、 数 据 库 访 问 、 用 户 
和 注册、 登录、 用 户 会 话 等 内 容 。 

我 们 会 介绍 Express HER, MVC 设计 模式 、ejs 模板 引擎 以 及 MongoDB 数据 库 的 操作 。 
通过 实战 溃 练 ， 你 将 会 了 解 到 网 站 开发 的 基本 方法 。 本 章 涉及 的 代码 较 多 ,所 有 的 代码 均 可 
以 在 www.byvoid.com/projectnode 找 到 ， 但 你 最 好 还 是 杂 目 输入 这 些 代 码 。 现 在 就 让 我 们 开 
始 一 起 动手 来 实现 一 个 微 博 网 站 吧 。 


5.1 准备 工作 


在 开始 动手 之 前 ， 我 们 首先 要 大 致知 道 Node.js 实现 网 站 的 工作 原理 。Node.js 和 PHP, 
Perl, ASP, JSP 一 样 ， 目 的 都 是 实现 动态 网 页 ， 也 就 是 说 由 服务 需 动 态 生 成 HTML 页 面 。 
之 所 以 要 这 么 做 ， 是 因为 静态 HTML 的 可 扩展 性 非常 有 限 ， 无 法 与 用 户 有 效 交 互 。 同 时 如 
采 有 大 量 相 似 的 内 容 ， 例 如 产品 介绍 页 面 ， 那 么 1000 个 产品 就 要 1000 个 静态 的 HTML 页 面 ， 
维护 这 1000 个 页 面 简直 是 一 场 灾 难 ， 因 此 动态 生成 HTML 页 面 的 技术 应 运 而 生 。 

最 早 实 现 动 态 网 页 的 方法 是 使 用 Per ”和 CGI。 在 Perl 程序 中 输出 HTML 内 容 , H HTTP 
服务 器 调用 Perl 程序 ， 将 结果 返回 给 客户 端 。 这 种 方式 在 互联 网 刚刚 兴起 的 20 世纪 90 年 代 
非常 流行 ， 几 乎 所 有 的 动态 网 页 都 是 这 么 做 的 。 但 问题 在 于 如 果 HTML 内 容 比较 多 ， 维 护 
非常 不 方便 。 大 概 在 2000 年 左右 ， 以 ASP、PHP、JSP 的 为 代表 的 以 模板 为 基础 的 语言 出 现 
了 ， 这 种 语言 的 使 用 方法 与 CGI 相反 ， 是 在 以 HTML 为 主 的 模板 中 插入 程序 代码 ”>。 这 种 方 
式 在 2002 年 前 后 非常 流行 , 但 它 的 问题 是 页 面 和 程序 逻辑 紧密 耦合 , 任何 一 个 网 站 规模 变 大 
以 后 ， 都 会 遇 到 结构 混乱 ， 难 以 处 理 的 问题 。 为 了 解决 这 种 问题 ， 以 MVC 架构 为 基础 的 平 
台 逐 渐 兴 起 ， 车 名 的 Ruby on Rails, Django, Zend Framework 都 是 基于 MVC 架构 的 。 

MVC ( Model-View-Controller, 模型 -视图 -控制 可 ) 是 一 种 软件 的 设计 模式 ， 它 最 早 是 
由 20 世纪 70 年 代 的 Smalltalk 语言 提出 的 ， 即 把 一 个 复杂 的 软件 工程 分 解 为 三 个 层面 : 模 
型 、 视 图 和 控制 右 。 

口 模型 是 对 象 及 其 数据 结构 的 实现 ， 通常 包含 数据 库 操作 。 

a 视图 表示 用 户 界 面 ， 在 网 站 中 通 稼 就 是 HTML 的 组 织 结构 。 

a 控制 器 用 于 处 理 用 户 请 求 和 数据 流 、 复 杂 模 型 ， 将 输出 传递 给 视图 。 

我 们 称 PHP, ASP, JSP 为 “模板 为 中 心 的 架构 ”"， 表 5-1 是 两 种 Web 开 发 架构 的 一 个 
对 比 。 



























































D 是 C++， 任 何 语言 都 可 以 ，Perl 只 是 最 常见 的 。 
@) 例 如 ASP 的 <% %$> 和 PHP 的 <?php ?> 标签 ， 在 这 些 标签 内 添加 处 理 代 码 。 
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表 5-1 Web 开发 染 构 对 比 








特 性 模板 为 中 心 染 构 MVC 架构 
页 面 产生 方式 执行 并 替换 标签 中 的 语句 由 模板 引擎 生成 HTML 页 面 
路 径 解 析 对 应 到 文件 系统 ” 由 控制 带 定 义 
数据 访问 通过 SQL 语句 查询 或 访问 文件 系统 对 象 关系 模型 
架构 中 心 脚本 语言 是 静态 HTTP 服务 器 的 扩展 静态 HTTP 服务 此 是 脚本 语言 的 补充 
xé Hye e] 小 规模 网 站 大 规模 网 站 
学 习 难 度 容易 较 难 





这 两 种 架构 都 出 目 原 始 的 CGI, 但 不 同 之 处 是 前 者 走 了 一 条 粗放 扩张 的 发 展 路 线 ， 由 于 
易学 易 用 ,在 几 年 前 应 用 较 广 ， 而 随 者 互联 网 规模 的 扩大 ,后 者 优势 逐渐 体现 ， 目 前 已 经 成 
为 主流 。 

Node.js KEEF Perl 或 C++ 一 样 , 都 可 以 作为 CGI 扩展 被 调用 , 但 它 还 可 以 跳 过 HTTP 
服务 器 ， 因 为 它 本 身 就 是 。 传 统 的 架构 中 HTTP 服务 器 的 角色 会 由 Apache、Nginx IIS 之 类 
的 软件 来 担任 ， 而 Nodejs KRE, Node.js 提供 了 http 模块 ， 它 是 由 C++ 实现 的 ， 性 能 
可 靠 ， 可 以 直接 应 用 到 生产 环境 。 图 5-1 是 一 个 简单 的 架构 示意 图 。 

















DUE. DE 


| 


HTTP 服务 器 Node 





(Apache,IIS,etc.) 


PHP 解释 器 


图 $-1 Node.js 与 PHP 架构 的 对 比 


Node.js 和 其 他 的 语言 相 比 的 男 一 个 显著 区 别 , 在 于 它 的 原始 封装 程度 较 低 ,例如 PHP 中 
你 可 以 访问 S_REQUEST 获取 客户 端的 POST 或 GET 请求， 通常 不 需要 直接 处 理 HTTP D 











CD 例如 http://example.com/hello/world.php 对 应 服务 器 上 的 /hello/world.php 这 个 文件 。 当 然 这 不 是 绝对 的 ， 现 在 很 多 
PHP 开 发 框架 都 是 只 提供 单个 人 口 ， 利 用 服务 器 的 Rewrite 支持 实现 了 路 径 的 自由 控制 。 我 们 一 般 情 况 下 指 的 是 
原生 的 (或 默认 的 ) 文 持 。 

(2) 或 者 说 不 是 必要 的 ， 因 为 你 也 可 以 把 Node.js 的 服务 器 当 作 Apache 或 Nginx 后 端 。 
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议 "。 这 些 语言 要 求 由 HTTP 服务 器 来 调用 ， 因 此 你 需要 设置 一 个 HTTP 服务 器 来 处 理 客户 
WFK, HTTP 服务 融通 过 CGI 或 其 他 方式 调用 脚本 语言 解释 着 ， 将 运行 的 结果 传递 回 
HTTP 服务 大 ,最 终 再 把 内 容 返 回 给 客户 问 。 而 在 Node.js P, 很 多 工作 需要 你 目 己 来 做 (并 
不 是 都 要 自己 动手 ， 因 为 有 第 三 方 框架 的 帮助 )。 


5.1.1 使 用 http 模块 


Node.js 由 于 不 需要 另外 的 HITP 服务 器 ， 因 此 减少 了 一 层 抽象 ， 给 性 能 带 来 不 少 提升 ， 
但 同时 也 因此 而 提高 了 开发 难度 。 举 例 来 说 ， 我 们 要 实现 一 个 POST 数据 的 表单 ， 例 如 : 


«form method="post" action-"http://localhost:3000/"»5 
«input type-"text" name-"title" /» 














«textarea name-"text"»«/textarea» 
«input type-"submit" /» 
«/form» 


这 个 表单 包含 两 个 字段 : title 和 text, IL POST 的 方式 将 请 求 发 送 给 
http://localhost:3000/。 假设 我 们 要 实现 的 功能 是 将 这 两 个 字段 的 东西 原封 不 动 地 返回 给 用 户 ， 
PHP 只 需 写 两 行 代 码 ， 储 存 为 index.php 放 在 网 站 根 目 录 下 即 可 : 


echo S$ POST['title']; 
echo S POST['text']; 


在 3.5.1 市 中 使 用 了 类 似 下 面 的 方法 (用 http 模 块 ): 


var http = require('http'); 








var querystring - require('querystring'); 


var Server 





http.createServer(function(regd, res) { 


var post 


req.on('data', function(chunk) { 
post += chunk; 


I3 


req.on('end', function() { 
post - querystring.parse(post); 


res.write(post.title); 
res.write(post.text); 
res.end(); 


33 


)).1isten(3000); 





D 比如 我 们 需要 知道 HTTP 成 功 啊 应 时 要 返回 一 个 200 状态 码 ， 而 不 需要 手动 完成 “返回 200 状态 码 ” 这 项 工作 。 
但 这 不 带 表 你 可 以 轻易 地 切换 到 非 HTTP 协议 ， 因 为 代码 仍然 是 与 HTTP 协议 耦合 的 。 
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这 种 差别 可 能 会 让 你 大 吃 一 怀 ，PHP 的 实现 要 比 Node.js 容 易 得 多 。Node.js 完成 这 样 一 
个 简单 任务 竟然 如 此 复杂 : 你 需要 先 创建 一 个 http 的 实例 ， 在 其 请 求 处 理 函 数 中 手动 编写 
req 对 象 的 事件 监听 需 。 当 客 户 端 数据 到 达 时 , 将 POST 数据 暂 存 在 财 包 的 变量 中 , 直到 ena 
事件 触发 ， 解 析 POST 请 求 ， 处 理 后 返回 客户 端 。 

其 实 这 个 比较 是 不 公平 的 , PHP 之 所 以 显得 简单 并 不 是 因为 它 没 有 做 这 些 事 ,而 是 因为 
PHP 已 经 将 这 些 工 作 完 全 封装 好 了 ， 只 提供 了 一 个 高 层 的 接口 ， 而 Nodejs 的 http 模块 提 
供 的 是 底层 的 接口 ， 尽 管 使 用 起 来 复杂 ， 却 可 以 让 我 们 对 HTTP 协议 的 理解 更 加 清晰 。 

但 是 等 等 , 我 们 并 不 是 为 了 理解 HITP 协议 才 来 使 用 Node.js 的 , 作为 Web 应 用 开发 者 ， 
我 们 不 需要 知道 实现 的 细节 ， 更 不 想 与 这 些 细节 纠 缠 从 而 降低 开发 效率。 难道 Node.js 的 抽 
象 如 此 之 差 ， 把 不 该 有 的 细节 都 暴露 给 了 开发 者 吗 ? 

KERE, Node.js 虽然 提供 了 http 模块 ， 却 不 是 让 你 直接 用 这 个 模块 进行 Web 开发 的 。 
http 模块 仅仅 是 一 个 HTTP 服务 右 内 核 的 封 汲 ， 你 可 以 用 和 它 做 任何 HTTP 服务 大 能 做 的 事 
情 ， 不 仅仅 是 做 一 个 网 站 ， 其 至 实现 一 个 HTTP 代理 服务 器 都 行 。 你 如 果 想 用 它 直 接 开发 网 
站 ， 那 么 就 必须 手动 实现 所 有 的 东西 了 ， 小 到 一 个 POST 请 求 ， 大 到 Cookie、 会 话 的 管理 。 
当 你 用 这 种 方式 建成 一 个 网 站 的 时 候 ， 你 就 几乎 已 经 做 好 了 一 个 完整 的 框 桨 了 。 



































5.1.2 Express 框架 


npm 提供 了 大 量 的 第 三 方 模块 ， 其 中 不 乏 许 多 Web 框架 ,我 们 没有 必要 重复 发 明 轮 子 ， 
因而 选择 使 用 Express 作为 开发 框架 ， 因 为 它 是 日 前 最 稳定 、 使 用 最 广泛 ， 而 且 Node.js 官 
方 推荐 的 唯一 一 个 Web 开发 框架 。 

Express ( http://expressjs.com/ ) 除了 为 nttp 模块 提供 了 更 高 层 的 接口 外 ， 还 实现 了 
许多 功能 ， 其 中 包括 : 

口 路 由 控制 ; 

OQ 模板 解析 文 持 ; 

OQ 动态 视图 ; 

a 用 户 会 话 ; 

口 CSRF 保护 ; 

口 静态 文件 服务 ; 

a 错误 控制 大 ; 

a 访问 日 志 ; 

a 绥 存 ; 

口 插件 文 持 。 

需要 指出 的 是 ，Express 不 是 一 个 无 所 不 包 的 全 能 框架 ，, 像 Rails 或 Django 那样 实现 了 
模板 引擎 甚至 ORM (Object Relation Model， 对 和 象 关 系 模型 ) 它 只 是 一 个 轻 量 级 的 Web TIE 














84 — $53 使 用 Node.js 进 行 Web 开发 
W, 多数 功能 只 是 对 HTTP 协议 中 常用 操作 的 封装 ， 更 多 的 功能 需要 插件 或 者 整合 其 他 模块 
来 完成 。 
下 面 用 Express 重新 实现 前 面 的 例子 : 








var express = require('express'); 





var app - express.createServer(); 





app.use(express.bodyParser()); 

app.all('/', function(reg, res) { 
res.send(req.body.title + req.body.text); 

j 


app.listen(3000); 


可 以 看 到 , 我 们 不 需要 手动 编写 rea 的 事件 监听 需 了 ， 只 需 加 载 express .bodyParser () 
就 能 直接 通过 reag .body 获取 POST 的 数据 了 。 


5.2 快速 开始 


在 上 一 人 小节 我 们 已 经 介绍 了 Web 开发 的 典型 染 构 ， 我们 选择 了 用 Express 作为 开发 框架 
来 开发 一 个 网 站 ， 从 现在 开始 我 们 就 要 真正 动手 实践 了 。 


5.2.1 安装 Express 





首先 我 们 要 安装 Express。 如 采 一 个 包 是 某 个 工程 依赖 ， 那 么 我 们 需要 在 工程 的 目录 下 
使 用 本 地 模式 安装 这 个 包 , 如 末 要 通过 命令 行 调用 这 个 包 中 的 命令 , 则 需要 用 全 局 模式 安 状 
(关于 本 地 模式 和 全 局 模式 , 参见 3.3.4 节 ), 因此 按理 说 我 们 使 用 本 地 模式 安装 Express 即 可 。 
但 是 Express 像 很 多 框架 一 样 都 提供 了 Quick Start ( 快速 开始 ) 工具 ， 这 个 工具 的 功能 通常 
是 建立 一 个 网 站 最 小 的 基础 框 保 ,在 此 基础 上 完成 开发 。 当 然 你 可 以 完全 自己 动手 , 但 我 还 
是 推荐 使 用 这 个 工具 更 快速 地 建立 网 站 。 为 了 使 用 这 个 工具 ， 我 们 需要 用 全 局 模式 安装 
Express， 因 为 只 有 这 样 我 们 才能 在 命令 行 中 使 用 它 。 运 行 以 下 命令 : 














S npm install -g express 


等 待 数秒 后 安装 完成 , 我 们 就 可 以 在 命令 行 下 通过 express 命令 快速 创建 一 个 项 目 了 。 
在 这 之 前 先 使 用 express --help 查看 帮助 信息 : 





Usage: express [options] [path] 
Options: 
-S, --gessions add session support 


-t, --template «engine» add template «engine» support (jadelejs). default-jade 
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-C, --CSS «engine» add stylesheet «engine» support (stylus). default-plain css 
-v, --version output framework version 
-h, --help output help information 


Express 在 初始 化 一 个 项 目的 时 候 需 要 指定 模板 引擎 ， 默 认 支 持 Jade 和 ejs， 为 了 降低 学 
习 难 度 我 们 推荐 使 用 ejs ”， 同 时 暂时 不 添加 CSS 引擎 和 会 话 支持 。 


5.2.2 建立 工程 
通过 以 下 命令 建立 网 站 基本 结构 : 


express -t ejs microblog 


当前 目录 下 出 现 了 子 目 录 microblog， 并 且 产 生 了 一 些 文件 : 





create : microblog 


+ 


create : microblog/package.json 


+ 


create : microblog/app.js 


create : microblog/public 


create : microblog/public/javascripts 


+ 


Create : microblog/public/images 














create : microblog/public/stylesheets/style.css 


+ 


create : microblog/routes 


+ 


create : microblog/routes/index.js 


+ 


create : microblog/views 


create : microblog/views/layout.ejs 











m 
m 
m 
m 
m 
m 
create : microblog/public/stylesheets 
m 
m 
m 
m 
m 
m 





+ 


create : microblog/views/index.ejs 





dont forget to install dependencies: 
$ cd microblog && npm install 


它 还 提示 我 们 要 进入 其 中 运行 nom install, 我 们 依照 指示 ， 结 果 如 下 : 


ejs@0.6.1 ./node modules/ejs 





express82.5.8 ./node modules/express 
— qs@Q0.4.2 

— mime@1 .2.4 

-— mkdirp@0.3.0 

— gponnectel.9.5 


它 目 动 安装 了 依赖 ejs 和 express。 这 是 为 什么 呢 ? 检查 目录 中 的 package.json X fF, Vj 


三 | 
AE: 





AN 


中 





(D ejs ( Embedded JavaScript ) 是 一 个 标签 蔡 换 引 擎 ,其 语法 与 ASP、PHP 相似 , 易于 学 习 , 目前 被 广泛 应 用 。Express 
默认 提供 的 引擎 是 jade， 它 颠覆 了 传统 的 模板 引擎 ， 制 定 了 一 套 完 整 的 语法 用 来 生成 HTML 的 每 个 标签 结构 ， 功 
能 强大 但 不 易学 习 。 
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"name": "microblog" 
"oerelon"s "0.0.1" 


"private": true 





"dependencies": { 
"exgpreset. WAS M D 
"ee e000 
} 
} 


其 中 dependencies 属性 中 有 express 和 ejs。 无 参数 的 npm install 的 功能 就 是 
检查 当前 目录 下 的 package.json， 并 目 动 安装 所 有 指定 的 依赖 。 


5.2.3 ”启动 服务 器 











用 Express 实现 的 网 站 实际 上 就 是 一 个 Node.js 程序 ,因此 可 以 直接 运行 ,我 们 运行 node 
app.js, 4& dl Express server listening on port 3000 in development modes 

接 下 来 , 打开 浏览 希 , 输入 地 址 http://localhost:3000, 你 就 可 以 看 到 一 个 简单 的 Welcome 
to Express 页 面 了 。 如 果 你 能 看 到 如 图 $-2 所 示 的 页 面 ， 那 么 说 明 你 的 设 定 正确 无 误 。 





+») Express 


c C 省 ®© localhost:3000 


:| 
P 





Express 


Welcome to Express 


图 $-2 Express 初始 欢迎 页 面 





要 关闭 服务 融 的 话 ， 在 终端 中 按 Ctrl + C。 注 意 ， 如 果 你 对 代码 做 了 修改 ， 要 想 看 到 修 
改 后 的 效果 必须 重 局 服务 希 , 也 就 是 说 你 需要 关闭 服务 融 并 册 次 运行 才 会 有 效 末 。 如 条 和 觉得 
有 些 态 烦 ， 可 以 使 用 supervisor 实现 监视 代码 修改 和 目 动 重启， 有 具体 使 用 方法 参见 3.1.3 市 。 
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e. 注意 命令 行 中 显示 服务 器 运行 在 开发 模式 下 (development mode), H 
提示 此 不 要 在 生产 环境 中 部 署 它 。 我 们 会 在 6.3 节 中 介绍 如 何在 真实 的 生产 环 


境 下 部 署 Node.js 服务 器 。 


5.2.4 工程 的 结构 


现在 让 我 们 回 过 头 来 看 看 Express 都 生成 了 哪些 文件 。 除 了 package.json, 它 只 产生 了 两 
个 JavaScript 文件 app.js 和 routes/index.js。 模 板 引 擎 ejs 也 有 两 个 文件 index.ejs 和 layout.ejs， 
此 外 还 有 样式 表 style.css。 下 面 来 详细 看 看 这 几 个 文件 。 





1. app.js 
appjs 是 工程 的 入 口 ， 我 们 先 看 看 其 中 有 什么 内 容 : 
/** 





* Module dependencies. 











5 
var express - require('express') 
, routes - require('./routes'); 
var app - module.exports - express.createServer(); 


// Configuration 


app.configure(function()( 
app.set('views', dirname + '/views'); 
app.set('view engine', 'ejs'); 
app.use(express.bodyParser()); 
app.use(express.methodOverride()); 
app.use(app.router); 

app.use(express.static(  dirname + '/public')); 


app.configure('development', function()( 
app.use(express.errorHandler((í dumpExceptions: true, showStack: true ))); 


kis 





app.configure('production', function()( 





app.use(express.errorHandler()); 


J); 

// Routes 

app.get('/', routes.index); 
app.listen(3000); 


console.log("Express server listening on port $d in $s mode", app.address().port, 
app.settings.env); 
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*f EE E— HEH Express 的 例子 ， 这 个 文件 长 了 不 少 ， 不 过 并 不 复杂 。 下 面 来 分 析 一 下 
这 段 代码 。 

首先 我 们 导入 了 Express 模块 ， 前 面 已 经 通过 npm 安装 到 了 本 地 ， 在 这 里 可 以 直接 通过 
require Io routes 是 一 个 文件 夹 形式 的 本 地 模块 ， 即 . /routes/index.js， 它 的 功能 
是 为 指定 路 径 组 织 返 回 内 容 , 相当 于 MVC 染 构 中 的 控制 副 。 通过 express.createServer() 
pacis 用 的 实例 ， 后 面 的 所 有 操作 都 是 针对 于 这 个 实例 进行 的 。 

接 下 来 是 三 个 app .configure 国 数 ， 分 别 指定 了 通用 、 开 发 和 产品 环境 下 的 参数 。 
第 一 个 app.configure 直接 接 受 了 一 个 回调 函数 ， 后 两 个 则 只 能 在 开发 和 产品 环境 中 调用 。 

app.set 是 Express 的 参数 设置 工具 ， 接 受 一 个 键 (key ) 和 一 个 值 (value )， 可 用 的 参 
数 如 下 所 示 。 

L] basepath: 基础 地 址 ， 通常 用 于 res.redirect() 跳 转 。 
views: 视图 文件 的 目录 ， 存 放 模 板 文 件 。 
view engine: 视图 模板 引擎 
view options: 全 局 视图 参数 对 象 。 
view cache: 局 用 视图 绥 存 。 
case sensitive routes: 路 径 区 分 大 小 写 。 
strict routing: 严格 路 径 ， 启 用 后 不 会 忽略 路 径 末 尾 的 “ / 
jsonp callback: 开启 透明 的 JSONP 文 持 。 

Express 依赖 于 connect, 提供 了 大 量 的 中 间 件 , 可 以 通过 app .use 启用。 app. configure 
中 启用 了 5 个 中 间 件 : bodyParser,methodOverride,router,static LA errorHandler, 
bodyParser 的 功能 是 解析 客户 端 请 求 ， 通 常 是 通过 POST 发 送 的 内 容 。methodOverride 
用 于 支持 定制 的 HTTP 方 法 *。router 是 项 目的 路 由 支持 。static 提供 了 静态 文件 支持 。 
errorHandler 是 错误 控制 兹 。 

app.get('/', routes.index); 是 一 个 路 由 控制 项 ， 用 户 如 果 访 问 “/ 7” 路径， 则 
由 routes.index 来 控制 。 

最 后 服务 名 通过 app.listen(3000); Jus], WiUr30009mL. 

2. routes/index.js 


routes/index.js 是 路 由 文件 ， 相 当 于 控制 硕 ， 用 于 组 织 展示 的 内 容 : 


/* 
* GET home page. 
a 








D DU UU UU UO 

















exports.index = function(reg, res) { 


(D 如 PUT、DELETE 等 HTTP 方 法 ， 浏 览 器 是 不 文 持 的 。 
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res.render('index', ( title: 'Express' )); 

}; 

app.]S 中 通过 app.get('/', routes.index); 4 “/” KRITE] exoorts.index 
函数 下 。 其 中 只 有 一 个 语句 res.render('index', { title: 'Express' }), 功能 是 
调用 模板 解析 引 苟 PEG S index 的 模板 ， 并 传人 一 个 对 和 象 作为 参数 ， 这 个 对 象 只 有 一 个 
属性 ， 即 title: 'Express'。 

3. index.ejs 

index.ejs 是 模板 文件 ， 即 routes/index.js 中 调用 的 模板 ， 内 容 是 : 


<h1><%= title $»«/hl» 
«p»Welcome to <%= title $»«/p» 


它 的 基础 是 HTML 语言 ， 其 中 包含 了 形 如 <%= title e» 的 标签 ， 功 能 是 显示 引用 的 
变量 ， 即 res.render 国 数 第 二 个 参数 传人 的 对 象 的 属性 。 

4. layout.ejs 

模板 文件 不 是 孤立 展示 的 , AEO BUS RAAH layoutejs, Bl «$- body $2 
MBIA EIERN, BARDEA, A AAEE ER 











<!DOCTYPE html> 
<html> 
<head> 
<title><%= title %></title> 
«link rel='stylesheet' href-'/stylesheets/style.css' /> 
</head> 
<body> 
<%- body %> 
</body> 
</html> 


LA Este DER T ER, F, RERA EKE RISE T 
中 基于 这 个 工程 继续 完善 ， 直 到 实现 一 个 功能 完整 的 网 站 。 
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在 上 一 节 ， 我 们 已 经 讲 过 了 如 何 使 用 Express 建立 一 个 基本 工程 ， 这 个 工程 只 包含 一 些 
基础 架构 ， 没 有 任何 实际 内 容 。 从 这 一 小 节 开 始 ， 我 们 将 会 讲述 Express 的 基本 使 用 方法 ， 
在 前 面 例子 的 基础 上 逐步 完善 这 个 工程 。 








5.3.1 工作 原理 


当 通 过 浏览 锅 访 问 app.js 建立 的 服务 带 时 ， 会 看 到 一 个 简单 的 页 面 ， 实 际 上 它 已 经 
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完成 了 许多 透明 的 工作 ， 现 在 就 让 我 们 来 解释 一 下 它 的 工作 机 制 ， 以 帮助 理解 网 站 的 整 
体 架 构 。 
访问 http:Wlocalhost:3000， 浏 览 硕 会 回 服务 人 句 发 送 以 下 请 求 : 


GET / HTTP/1.1 

Host: localhost:3000 

Connection: keep-alive 

Cache-Control: max-age=0 

User-Agent: Mozilla/5.0 AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.142 
Safari/535.19 

Accept: text/html,application/xhtml+xml,application/xml ;gq=0.9,*/*;q=0.8 

Accept-Encoding: gzip,deflate,sdch 

Accept-Language: zh;qsz0.8,en-US;qs0.6,en;qz2s0.4 

Accept-Charset: UTF-8,*;qz2z0.5 


其 中 第 一 行 是 请 求 的 方法 、 路 径 和 HTTP 协 议 版 本 , 后 面 若干 行 是 HITP 请 求 头 。app 会 
解析 请 求 的 路 径 ， 调 用 相应 的 逻辑 。appjs 中 有 一 行内 容 是 app.get ('/'， routes.index), 
它 的 作用 是 规定 路 径 为 “/” 的 GET 请 求 由 routes .index 图 数 处 理 。routes .indqex 通 
zl res.render('index', ( title: 'Express' }) 调用 视图 模板 index, 传递 title 
变量 。 最 终 视 图 模板 生成 HTML p», BERN vide, XXIII ZEE: 

















HTTP/1.1 200 OK 

X-Powered-By: Express 

Content-Type: text/html; charset-utf-8 
Content-Length: 202 

Connection: keep-alive 


<!DOCTYPE html> 
<html> 
<head> 
<title>Express</title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
<body> 
<h1>Express</h1> 
<p>Welcome to Express</p> 
</body> 
</html> 


浏览 硕 在 接收 到 内 容 以 后 ， 经 过 分 析 发 现 要 获取 /stylesheets/style.css, ER PEAUX mk 
FARRER KRK appjs 中 并 没有 一 个 路 由 规则 指派 到 /stylesheets/style.css, {8 apo 通过 
app.use(express.static(  dirname + '/public')) ME J MAXFIRE A, KAE 
/stylesheets/style.css 会 定 回 到 app.js 所 在 目录 的 子 目 录 中 的 文件 public/stylesheets/style.css ， 
问 客户 端 返回 以 下 信息 : 
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HTTP/1.1 200 OK 

X-Powered-By: Express 

Date: Mon, 02 Apr 2012 15:55:55 GMT 
Cache-Control: public, max-age-0 
Last-Modified: Mon, 12 Mar 2012 12:49:50 GMT 
ETag: "110-1331556590000" 

Content-Type: text/css; charset=UTF-8 





Accept-Ranges: bytes 
Content-Length: 110 


Connection: keep-alive 


body { 

padding: 50px; 

font: 14px "Lucida Grande", Helvetica, Arial, sans-serif; 
j 
a ( 


color: #00B7FF; 
} 


由 Express 创建 的 网 站 架构 如 图 $-3 所 示 。 








FR E PE tli 


模板 对 象 
引擎 模型 





图 $-3 Express 网 站 的 架构 


这 是 一 个 典型 的 MVC 架构 ， 浏 览 髓 发 起 请 求 ， 由 路 由 控制 天 接受 ， 根 据 不 同 的 路 径 定 
回 到 不 同 的 控制 融 。 控 制 融 处 理 用 户 的 具体 请 求 ， 可 能 会 访问 数据 库 中 的 对 象 ， 即 模型 部 
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分 。 控 制 器 还 要 访问 模板 引擎 ， 生 成 视图 的 HTML， 最 后 再 由 控制 祷 返 回 给 浏览 器 ， 完 成 
一 次 请 求 。 
5.3.2 创建 路 由 规则 


当 我 们 在 浏览 需 中 访问 譬如 http://localhost:3000/abe 这 样 不 存在 的 页 面 时 ， 服 务 融 会 在 
吧 应 头 中 返回 404 Not Found. 错误 ， 浏 览 硕 显示 如 几 5$-4 所 示 。 





+) localhost:3000/abc 
一 CQ f  (localhost:3000/abc vga A 


Cannot GET /abc 





图 $-4 ”访问 不 存在 的 页 面 时 浏览 带 看 到 的 结 


这 是 因为 /abc 是 一 个 不 存在 的 路 由 规则 ,而 且 它 也 不 是 一 个 public 目录 下 的 文件 ， 所 以 
Express 返 回 了 404 Not Found 的 错误 。 

接 下 来 我 们 会 讲述 如 何 创建 路 由 规则 。 

假设 我 们 要 创建 一 个 地 址 为 /hello 的 页 面 ， 内 容 是 当前 的 服务 硕 时 间 ， 证 我 们 看 看 具 
体 做 法 。 打 开 app.]s, 在 已 有 的 路 由 规则 app.get('/', routes.index) 后 面 添加 一 行 : 





app.get('/hello', routes.heLlo): 
修改 routes/index.js， 增 加 hello PR: 


/* 
* GET home page. 
uf i 


exports.index = function(reqg, res) { 


res.render('index', { title: 'Express' )); 
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exports.hello = function(req, res) ( 
res.send('The time is ' + new Date().toString()); 


}; 
重启 app.js， 在 浏览 器 中 访问 http://localhost:3000/hello， 可 以 看 到 类 似 于 图 5-5 的 页 面 ， 
刷新 页 面 可 以 看 到 时 间 发 生变 化 ， 因 为 你 看 到 的 内 容 是 动态 生成 的 结果 。 





(^5 localhost:3000/hello 


=- CQ f ®© localhost:3000/hello Tr H4 EN 


The time is Tue Apr 03 2012 01:32:33 GMT--0800 (CST) 








图 5-5 访问 /hello 时 显示 的 内 容 


服务 天 在 开始 监听 之 前 ,设置 好 了 所 有 的 路 由 规则 , 当 请 求 到 达 时 直接 分 配 到 啊 应 函数 。 
app.get 是 路 由 规则 创建 函数 ， 它 接受 两 个 参数 ， 第 一 个 参数 是 请 求 的 路 径 ， 第 二 个 参数 
是 一 个 回调 孔 数 ,该 路 由 规则 被 触发 时 调用 回调 孔 数 ， 其 参数 表 传 递 两 个 参数 ,分 别 是 req 
和 res， 表 示 请 求 信息 和 响应 信息 。 








5.3.3 ”路 径 匹 配 

上 面 的 例子 是 为 固定 的 路 径 设置 路 由 规则 ，Express 还 支持 更 高 级 的 路 径 匹 配 模式 。 例 
如 我 们 想 要 展示 一 个 用 户 的 个 人 页 面 ， 路径 为 /user/[username]， 可 以 用 下 面 的 方法 定义 路 由 
规则 : 








app.get('/user/:username', function(reg, res) { 
res.send('user: ' + req.params.username); 


HJ 
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修改 以 后 重启 app.js， 访 问 http://localhost:3000/user/byvoid， 可 以 看 到 页 面 显 示 了 以 下 
内 容 : 


user: byvoid 


路 径 规则 /user/:username 会 被 目 动 编 详 为 正则 表达 式 , 类 似 于 \/user\/ CE^N/14) N72 
这 样 的 形式 。 路 径 参 数 可 以 在 啊 应 消 数 中 通过 req.params 的 属性 访问 。 

路 径 规 则 同样 文 持 JavaScript EMRAN, 例如 app.get (\/user\/ CE^N/19) N72, 
callback). 这样 的 好 处 在 于 可 以 定义 更 加 复杂 的 路 径 规 则 , 而 不 同 之 处 是 匹配 的 参数 是 匿 
名 的 ， 因 此 需要 通过 req.params[10] 、req.params[1] 这 样 的 形式 访问 。 














5.3.4 REST 风格 的 路 由 规则 


Express 文 持 REST 风格 的 请 求 方式 ,在 介绍 之 前 我 们 先 说 明 一 下 什么 是 REST。REST 的 
意思 是 表征 状态 转移 (Representational State Transfer )， 它 是 一 种 基于 HTTP 协议 的 网 络 应 
用 的 接口 风格 ， 充 分 利用 HTTP 的 方法 实现 统一 风格 接口 的 服务 。HTTP 协议 定义 了 以 下 8 
种 标准 的 方法 。 

口 GET: 请 求 获取 指定 资源 。 

HEAD: 请 求 指定 资源 的 啊 应 头 。 

POST: 问 指 定 资源 提交 数据 。 

PUT: 请 求 服务 器 存储 一 个 资源 。 

DELETE: 请 求 服务 顺 删 除 指定 资源 。 

TRACE: 回 显 服务 器 收 到 的 请 求 ， 主 要 用 于 测试 或 诊断 。 

CONNECT: HTTP/1.1 协议 中 预 留 给 能 够 将 连接 改 为 管道 方式 的 代理 服务 天 。 
OPTIONS: 返回 服务 需 文 持 的 HTTP 请 求 方法 。 

其 中 我 们 经 常用 到 的 是 GET、POST、PUT 和 了 DELETE 方法。 根据 REST 设 计 模 式 ， 这 
4 种 方法 通常 分 别 用 于 实现 以 下 功能 。 

口 GET: 获取 

口 POST: 新 增 

a PUT: 更 新 

口 DELETE: 删除 

这 是 因为 这 4 种 方法 有 不 同 的 特点 ， 按 照 定 义 ， 它们 的 特点 如 表 5-2 所 示 。 

所 谓 安 全 是 指 没 有 副作用 , 即 请 求 不 会 对 资源 产生 变动 , 连续 访问 多 次 所 获得 的 结果 不 
受 访问 者 的 影响 。 而 索 等 指 的 是 重复 请 求 多 次 与 一 次 请 求 的 效果 是 一 样 的 ， 比 如 获取 和 更 
新 操作 是 客 等 的 ， 这 与 新 增 不 同 。 删 除 也 是 帘 等 的 ， 即 重复 删除 一 个 资源 ， 和 删除 一 次 是 
一 样 的 。 
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表 5-2 REST 风 格 HTTP 请 求 的 特点 


请 求 方式 安 全 m 等 
GET 是 是 
POST T E 
PUT ff 是 
DELETE 否 是 


Express 对 每 种 HTTP 请 求 方法 都 设计 了 不 同 的 路 由 绑 定 函数 ,例如 前 面 例子 全 部 是 
app .get ， 表 示 为 该 路 径 绑 定 了 了 GET 请 求 ， 问 这 个 路 径 发 起 其 他 方式 的 请 求 不 会 被 啊 应 。 
K 5-3 是 Express 支持 的 所 有 HTTP 请 求 的 绑 定 呆 数 。 


表 5-3 “Express 支持 的 HTTP 请 求 的 绑 定 函数 











请 求 方式 绑 定 函 数 

GET app.get (path, callback) 
POST app.post (path, callback) 
PUT app.put (path, callback) 
DELETE app.delete(path, callback) 
PATCH ? app.patch (path, callback) 
TRACE app.trace (path, callback) 
CONNECT app.connect (path, callback) 
OPTIONS app.options (path, callback) 
所 有 方法 app.all(path, callback) 


例如 我 们 要 绑 定 某 个 路 径 的 POST 请 求 ， 则 可 以 用 app.post(path, callback) E 
方法 。 需 要 注意 的 是 app.all 图 数 ， 它 文 持 把 所 有 的 请 求 方式 绑 定 到 同一 个 啊 应 基数 ， 
一 个 非常 灵活 的 函数 ， 在 后 面 我 们 可 以 看 到 许多 功能 都 可 以 通过 它 来 实现 。 


5.3.5 ”控制 权 转 移 
Express 文 持 同一 路 径 绑 定 多 个 路 由 啊 应 滑 数 ， 例 如 : 








app.all('/user/:username', function(reg, res) { 
res.send('all methods captured'); 


123 
app.get('/user/:username', function(í(reg, res) { 
res.send('user: ' + req.params.username); 


1753 


(D PATCH 方式 是 IETF RFC 5789 ( http://tools.ietf.org/html/rfc5789 ) 新 增 的 HTTP 方 法， 功能 定义 是 部 分 更 新 某 个 
AA WYR o 
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但 当 你 访问 任何 被 这 两 条 同样 的 规则 匹配 到 的 路 径 时 , 会 发 现 请 求 总 是 被 前 一 条 路 由 规 
则 捕获 ， 后 面 的 规则 会 被 忽略 。 原 因 是 Express 在 处 理 路 由 规则 时 ， 会 优先 匹配 先 定义 的 路 
由 规则 ， 因 此 后 面相 同 的 规则 和 被 屏 散 。 

Express 提供 了 路 由 控制 权 转 移 的 方法 ， 即 回调 函数 的 第 三 个 参数 next ， 通 过 调用 
next () ， 会 将 路 由 控制 权 转 移 给 后 面 的 规则 ， 例 如 : 





app.all('/user/:username', function(reg, res, next) { 
console.log('all methods captured'); 


next(); 

13 

app.get('/user/:username', function(reg, res) { 
res.send('user: ' + req.params.username); 


333 


当 访 问 被 匹配 到 的 路 径 时 ， 如 http:/localhost:3000/usercarbo， 会 发 现 终端 中 打印 了 all 
methods captured, 而 且 浏 览 硕 中 显示 了 users Carbo». 这 说 明 请 求 先 被 第 一 条 路 由 规 
则 捕获 ， 完 成 console.log 使 用 next () 转移 控制 权 ， 又 被 第 二 条 规则 捕获 ， 回 浏览 硕 
返回 了 信息 。 

这 是 一 个 非常 有 用 的 工具 , 可 以 让 我 们 轻易 地 实现 中 间 件 ， 而 且 还 能 提高 代码 的 复 用 程 
度 。 例 如 我 们 针对 一 个 用 户 查 询 信 息 和 修改 信息 的 操作 ， 分 别 对 应 了 GET 和 PUT 操作， 而 
两 者 共有 的 一 个 步 嗓 是 检查 用 户 名 是 否 合 法 ， 因 此 可 以 通过 next () 方法 实现 : 








var users = { 
'byvoid': x 
name: 'Carbo', 


website: 'http://www.byvoid.com' 
j 
E 


app.all('/user/:username', function(req, res, next) { 
// 检查 用 户 是 否 存在 
if (users[req.params.username]) ( 
next(); 
j else ( 
next (new Error(reqg.params.username + ' does not exist.')); 
j 
1); 
app.get('/user/:username', function(í(reg, res) { 


// 用 户 一 定 存 在 ， 直 接 展 示 
res.send(JSON.stringify(users[req.params.username])); 
FI? 
app.put('/user/:username', function(req, res) { 
// 修改 用 户 信息 
res.send('Done'); 


}); 
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上 面 例子 中 ，app.all 定义 的 这 个 路 由 规则 实际 上 起 到 了 中 间 件 的 作用 ， 把 相似 请 求 
的 相同 部 分 提取 出 来 ， 有 利于 代码 维护 其 他 next 方 法 如 果 接 受 了 参数 ， 即 代表 发 生 了 错误 。 
使 用 这 种 方法 可 以 把 错误 检查 分 段 化 ， 降 低 代 码 耦 合 度 。 


5.4 模板 引擎 


上 一 节 我 们 介绍 了 Express 的 路 由 控制 方法 , 它 是 网 站 染 构 最 核心 的 部 分 ， 即 MVC 染 构 
中 的 控制 带 。 在 这 一 小 厄 里 ,我 们 会 讲述 模板 引擎 的 使 用 和 集成 ， 也 就 是 视图 。 视 图 决定 了 
用 户 最 终 能 看 到 什么 , 因此 也 是 最 重要 部 分 , 这 里 我 们 以 ejs 为 例 介绍 模板 引擎 的 使 用 方法 。 


5.4.1 什么 是 模板 引擎 


模板 引擎 ( Template Engine ) 是 一 个 从 页 面 模 板 根据 一 定 的 规则 生成 HIML 的 工具 。 € 
HJ AI n] EARS 1996 年 PHP 2.0 的 诞生 。PHP 原本 是 Personal Home Page Tools (个 人 主 
页 工具 ) 的 简称 ， 用 于 取代 Perl 和 CGI 的 组 合 ， 其 功能 是 让 代码 通 入 在 HTML 中 执行 ， 以 
产生 动态 的 页 面 ， 因 此 PHP 堪 称 是 最 早 的 模板 引擎 的 锥 形 。 随 后 的 ASP、JSP 都 沿用 了 这 个 
模式 ， 即 建立 一 个 HTML 页 面 模板 ,插入 可 执行 的 代码 ， 运 行 时 动态 生成 HTML. 

按照 这 种 模式 ， 整 个 网 站 就 由 一 个 个 的 页 面 模板 组 成 , 所 有 的 逻辑 都 般 和 在 模板 中 。 这 
种 模式 大 大 降低 了 动态 网 页 开发 的 门槛 ,因此 一 开始 很 受 欢 迎 , 但 随 着 规模 的 扩大 它 会 遇 到 
许多 问题 ， 下 面 列举 几 个 主要 的 。 

口 页 面 功 能 逻辑 与 页 面 布局 样式 耘 合 ， 网 站 规模 变 大 以 后 逐渐 难以 维护 。 

Q 语法 复杂 ， 对 于 非 技 术 的 网 页 设计 者 来 说 门 覃 较 高 ， 难 以 学 习 。 

a 功能 过 于 全 面 ， 页 面 设计 者 可 以 在 页 面 上 编程 ， 不 利于 功能 划分 ， 也 使 模板 解析 效 

AST 

这 些 问题 制约 了 早期 模板 引擎 的 发 展 ， 直 到 MVC TIEN EU. EURSISEA T as HU 
开花 。 现 代 的 模板 引擎 是 MVC 的 一 部 分 ， 在 功能 划分 上 它 严 格 属 于 视图 部 分 ， 因 此 功能 以 
生成 HTML 页 面 为 核心 ， 不 会 引入 过 多 的 编程 语言 的 功能 。 相 较 于 一 门 编程 语言 ， 它 通 稼 
学 习 起 来 相当 容 多 。 

模板 引擎 的 功能 是 将 页 面 模板 和 要 显示 的 数据 结合 起 来 生成 HTML 页 面 。 它 既 可 以 运 
行 在 服务 右 端 义 可 以 运行 在 客户 问 ， 大 多 数 时 候 它 都 在 服务 带 并 卫 接 被 解析 为 HTML, 解析 
完成 后 再 传输 给 客户 端 ， 因 此 客户 端 甚至 无 法 判断 页 面 是 否 是 模板 引擎 生成 的 。 有 时 候 模 板 
引擎 也 可 以 运行 在 客户 端 ， 即 浏览 咒 中 ， 典 型 的 代表 就 是 XSLT， 它 以 XML 为 输入 ， 在 客 
Pim HTML 页 面 。 但 是 由 于 浏览 旭 莱 容 性 问题 XSLT 并 不 是 很 流行 。 目 前 的 主流 还 是 
由 服务 从 运行 模板 引擎 。 

TE MVC IE, 模板 引擎 包含 在 服务 天 端 。 控 制 顶 得 到 用 户 请 求 后 ,从 模型 获取 数据 ， 
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调用 模板 引擎 。 模 板 引擎 以 数据 和 页 面 模板 为 输入 ， 生 成 HIML 页 面 ， 然 后 返回 给 控制 耸 ， 
Hist soc nA mo Bd5-6 是 模板 引擎 在 MVC 架构 中 的 示意 图 。 


模板 引擎 





HTML 页 面 


图 5-6 ”模板 引擎 在 MVC 架构 中 的 位 置 


5.4.2. ”使 用 模板 引擎 


基于 JavaScript 的 模板 引擎 有 许多 种 实现 ， 我 们 推荐 使 用 ejs (Embedded JavaScript ), 
因为 它 十 分 简单 ， 而 且 与 Express 集成 良好 。 由 于 它 是 标准 JavaScript 实现 的 ， 因 此 它 不 仅 
可 以 运行 在 服务 硕 闪 ， 还 可 以 运行 在 浏览 顶 中 。 我 们 这 一 草 的 示例 是 在 服务 仙 冯 运行 ejs， 
这 样 减少 了 对 浏览 各 的 依赖 ， 而 且 更 符合 传统 架构 的 习惯 。 

我 们 在 app.js 中 通过 以 下 两 个 语句 设置 了 模板 引擎 和 页 面 模 板 的 位 置 : 








app.set('views', __dirname + '/views'); 


app.set('view engine', 'ejs'); 


表明 要 使 用 的 模板 引擎 是 ejs， 页 面 模板 在 views f Ho* Fo TE routes/index.js 的 
exports.index 图 数 中 通过 如 下 语句 调用 模板 引擎 : 


res.render('index', { title: 'Express' )); 

res.render 的 功能 是 调用 模板 引擎 ， 并 将 其 产生 的 页 面 下 接 人 返回 给 客户 端 。 它 接受 
两 个 参数 ， 第 一 个 是 模板 的 名 称 ， 即 views 目录 下 的 模板 文件 名 ， 不 包含 文件 的 扩展 名 ; 第 
二 个 参数 是 传递 给 模板 的 数据 ， 用 于 模板 翻译 。index.ejs 内 容 如 下 : 





«hi»«$2 title $»«/hi» 
«p»Welcome to <%= title %></p> 


上 面 代码 其 中 有 两 处 <%=- title $», HH TEUER. V WEBBER] SNA 
成 Express, 因为 res.render 传递 了 { title: 'Express' }o 
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ejs 的 标签 系统 非常 简单 ， 它 只 有 以 下 3 种 标签 。 

Q <% code %>: JavaScript fV fid. 

O <%= code $»: 显示 符 换 过 HTML 特殊 字符 的 内 容 。 
O «$- code $»: 显示 原始 HTML 内 容 。 

我 们 可 以 用 它们 实现 页 面 模板 系统 能 实现 的 任何 内 容 。 


5.4.3 页面 布 局 


上 面 的 例子 介绍 了 页 面 模板 的 翻译 ， 但 我们 看 到 的 不 止 这 两 行 ， 原因 是 Express 还 目 动 
套用 了 layout.ejs， 它 的 内 容 是 : 


<!DOCTYPE html> 
<html> 
<head> 
«title»«$- title %></title> 
«link rel-'stylesheet' href-'/stylesheets/style.css' /> 
</head> 
<body> 
<%- body %> 
</body> 
</html> 


layout.ejs 是 一 个 页 面 布局 模板 , 它 描述 了 整个 页 面 的 框架 结构 ,默认 情况 下 每 个 单独 的 
页 面 都 继承 自 这 个 框架 ， 替 换 掉 <-%- body e» 部 分 。 这 个 功能 通常 非常 有 用 ， 因 为 一 般 为 
了 保持 整个 网 站 的 一 致 风格 ，HTML 页 面 的 <head> 部 分 以 及 页 眉 页 脚 中 的 大 量 内 容 是 重复 
的 ， 因 此 我 们 可 以 把 它们 放 在 layout.ejs 中 。 当 然 ， 这 个 功能 并 不 是 强制 的 ， 如 果 想 关闭 它 ， 
可 以 在 app.js 的 中 app.configure 中 添加 以 下 内 容 ， 这 样 页 面 布局 功能 就 被 关闭 了 。 





app.set('view options', { 
layout: false 


}); 

万 一 种 情况 是 , 一 个 网 站 可 能 需要 不 止 一 种 页 面 布局 , 例如 网 站 分 前 台 展 示 和 后 台 管 理 
系统 ， 两 者 的 页 面 结 构 有 很 大 的 区 别 , 一 套 页 面 布局 不 能 满足 需求 。 这 时 我 们 可 以 在 页 面 模 
板 翻 详 时 指定 页 面 布 局 ， 即 设置 layout 属性 ， 例 如 : 








function(req, res) ( 





res.render('userlist', { 
title: :用 户 列表 -后 台 管 理 系 统 ' ， 
layout: 'admin' 


2E 
i2. 


这 段 代 码 会 在 翻译 userlist 页 面 模板 时 套用 admin.ejs 作为 页 面 布局 。 
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5.4.4. 片段 视图 

Express 的 视图 系统 还 支持 片段 视图 (partials ), 它 就 是 一 个 页 面 的 片段 , 通常 是 重复 的 
内 容 ， 用 于 迭代 显示 。 通 过 它 你 可 以 将 相对 独立 的 页 面 块 分 割 出 去 , 而且 可 以 避免 显 式 地 使 
用 for 循环 。 让 我 们 看 一 个 例子 ， 在 appjjs 中 新 增 以 下 内 容 : 











app.get('/list', function(req, res) { 
res.render('list', { 
title: 'Lrsct', 
items: [1991, 'byvoid', 'express', 'Node.js'] 


}); 
Jg 


在 views 目录 下 新 建 listejs， 内 容 是 : 

«ul»«$- partial('listitem', items) $»«/ul» 

同时 新 建 listitem.ejs， 内 容 是 : 

«li»«$- listitem $»«/li» 

访问 http://localhost:3000/list， 可 以 在 源 代 码 中 看 到 以 下 内 容 : 


<!DOCTYPE html» 
<html> 
<head> 
«title»List«/title» 
«link rel-'stylesheet' href-'/stylesheets/style.css' /» 
«/head» 
«body» 
«ul»«1i»1991«/li»«li»byvoid«/li»«li»express«/li»«li»Node.js«/li»«/ul» 
«/body» 
</html> 


partial 是 一 个 可 以 在 视图 中 使 用 函数 ， 它 接受 两 个 参数 ,第 一 个 是 片段 视图 的 名 称 ， 
第 二 个 可 以 是 一 个 对 象 或 一 个 数组 ， 如果 是 一 个 对 象 , 那么 厂 段 视图 中 上 下 文 变量 引用 的 就 
是 这 个 对 象 ; 如 果 是 一 个 数组 ,那么 其 中 每 个 元 素 依次 被 迭代 应 用 到 卢 段 视图 。 户 段 视图 中 
上 下 文 变 量 名 就 是 视图 文件 名 ,例如 上 面 的 'listitem'。 











5.4.5 ”视图 助手 


Express 提供 了 一 种 叫做 视图 助手 的 工具 ， 它 的 功能 是 允许 在 视图 中 访问 一 个 全 局 的 国 数 
或 对 象 ， 不 用 每 次 调用 视图 解析 的 时 候 单 独 传人 。 前 面 提 到 的 partial 就 是 一 个 视图 助手 。 

视图 助手 有 两 类 , 分 别 是 退 态 视图 助手 和 动态 视图 助手 。 这 两 者 的 差别 在 于 ， 议 人 态 视 图 
助手 可 以 是 任何 类 型 的 对 象 ， 包括 接 受 任 意 参 数 的 负数 ， 但 访问 到 的 对 象 必 须 是 与 用 户 请 求 无 
关 的 , 而 动态 视图 助手 只 能 是 一 个 函数 , 这 个 函数 不 能 接受 参数 , 但 可 以 访问 req 和 res 对 象 。 
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静态 视图 助手 可 以 通过 app.helpers 0 因数 注册 ， 它 接受 一 个 对 象 ， 对 象 的 每 个 属性 名 
称 为 视图 助手 的 名 称 , 属性 值 对 应 视图 助手 的 值 , 动态 视图 助手 则 通过 app .dynamicHelpers () 
注册 , 方法 与 静态 视图 助手 相同 , 但 每 个 属性 的 值 必须 为 一 个 函数 , 该 函数 提供 req 和 res, 
参见 下 面 这 个 示例 : 


var util = require('util'); 


app.helpers(í 
inspect: function(obj) ( 
return util.inspect(obj, true); 
} 
133 


app.dynamicHelpers(í 
headers: function(reqg, res) ( 
return reqg.headers; 
j 
BE 





app.get('/helper', function(req, res) { 
res.render('helper', { 
title: 'Helpers' 
prs 
133 


对 应 的 视图 helper、ejs 的 内 容 如 下 : 








«$-inspect (headers)%$> 


访问 http://localhost:3000/helper 可 以 看 到 如 图 5-7 所 示 的 内 容 。 


(^5 Helpers 


€ Q f ®© localhost:3000/helper Zo RA 





( 'accept-encoding*: 'gzip,deflate,sdch', 'accept-language'": 'zh- TW,zh;q-0.8,en- 
US;q-0.6,en;q-0.4', accept: 

'text/html,application/xhtml --xml,application/xml;q-0.9,*/*:q-0.8', 'accept-charset': 
'UTF-8,*:420.5', connection: 'keep-alive', 'cache-control': 'max-age-0', host: 
'localhost:3000', 'user-agent": 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10 7 3) 
AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.142 Safari/535.19' ] 





图 $-7 使 用 视图 助手 的 页 面 
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视图 助手 的 本 质 其 实 就 是 给 所 有 视图 注册 了 全 局 变量 , 因此 无 需 每 次 在 调用 模板 引擎 时 
传递 数据 对 象 。 当 我 们 在 后 面 使 用 session 时 会 发 现 它 是 非常 有 用 的 。 





5.5 建立 微 博 网 站 


在 前 面 的 几 节 中 ， 我 们 已 经 对 Express 进行 了 基本 的 介绍 ， 现 在 让 我 们 动手 开始 创建 一 
个 微 博 网 站 吧 。 


5.5.1 功能 分 析 


开发 中 的 一 个 大 忌 就 是 没有 想 清楚 要 做 什么 就 开始 动手 , 因此 我 们 准备 在 动手 实践 之 前 
先 规划 一 下 网 站 的 功能 ， 即 使 是 出 于 学 习 目 的 也 不 例外 。 首 先 ， 微 博 应 该 以 用 户 为 中 心 ， 
此 需要 有 用 户 的 注册 和 登录 功能 。 微 博 网 站 最 核心 的 功能 是 信息 的 发 表 , 这 个 功能 涉及 许多 
方面 ,包括 数据 库 访问 、 前 问 显 示 等 。 一 个 完整 的 微 博 系统 应 该 文 持 信息 的 评论 、 转 发 、 圈 
点 用 户 等 功能 , 但 出 于 演示 目的 ,我 们 不 能 一 一 实现 所 有 功能 ， 只 是 实现 一 个 微 博 社 交 网 站 
MWEE 




















5.5.2 ”路 由 规划 


在 完成 功能 设计 以 后 ,下 一 个 要 做 的 事情 就 是 路 由 规划 了 。 路 由 规划 ， 或 者 说 控制 硕 规 
划 是 整个 网 站 的 骨架 部 分 ,因为 它 处 于 整个 染 构 的 枢纽 位 置 , 相当 于 各 个 接口 之 间 的 粘 合 剂 ， 
所 以 应 该 优先 考虑 。 

根据 功能 设计 ， 我 们 把 路 由 按照 以 下 方案 规划 。 

口 /: 首页 

O /u/[user]: 用 户 的 主页 

口 /post: 发 表 信 息 

口 /reg: 用 户 注 册 

口 /login: 用 户 登 录 

口 /logout: 用 户 登 出 

以 上 页 面 还 可 以 根据 用 户 状态 细 分 。 发 表 信 息 以 及 用 户 登 出 页 面 必 须 是 已 登录 用 户 才能 
操作 的 功能 ， 而 用 户 注 册 和 用 户 登 入 所 面 回 的 对 象 必 须 是 未 登入 的 用 户 。 首 页 和 用 户主 页 则 
针对 已 登入 和 未 登入 的 用 户 显 示 不 同 的 内 容 。 

打开 appjs， 把 Routes 部 分 修改 为 : 




















app.get('/', routes.index); 
app.get('/u/suser', routes.user); 
app.post('/post', routes.post); 
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app.get('/reg', routes.reg); 
app.post('/reg', routes.doReg); 
app.get('/login', routes.login); 
app.post('/login', routes.doLogin);: 
app.get('/logout', routes.logout); 


其 中 /post、/login 和 /reg 由 于 要 接受 表单 信息 ， 因 此 使 用 app .post 注册 路 由 。 /login 
和 /reg 还 要 显示 用 户 注 册 时 要 填写 的 表单 ， 所 以 要 以 app .get 注册 。 同 时 在 routes/index.js 
中 添加 相应 的 函数 : 











exports.index = function(reqg, res) { 
res.render('index', ( title: 'Express' }); 

I4 

exports.user = function(reg, res) { 

); 

exports.post = function(reg, res) { 

I 

exports.reg = function(reg, res) { 

13 

exports.doReg = function(reqg, res) ( 

14 

exports.login = function(reqg, res) { 

); 

exports.doLogin = function(req, res) ( 

Hn 

exports.logout = function(reqg, res) ( 


}; 
我 们 将 在 $.6 节 介绍 会 话 (session )， 说 明 如 何 管 理 用 户 的 状态 。 


5.5.3 SEE 


我 们 在 开发 网 站 的 时 候 必须 时 刻意 识 到 网 站 是 为 用 户 开 发 的 , 因而 用 户 界面 是 非常 重要 
的 。 一 种 普 志 的 观点 是 后 端的 开发 者 不 必 太 多 关注 前 疾 用 户 体验 ,因为 这 是 前 闪 程 序 员 和 设 
计 师 要 做 的 事情 。 但 实际 上 为 了 设计 一 个 优雅 的 界面 ， 后 端 程序 员 也 不 得 不 介入 功能 实现 ， 
为 很 多 时 候 前 端 和 后 并 无 法 完全 划分 , 仅仅 徘 前 器 开 发 者 是 无 法 设计 出 优美 而 又 可 用 的 界 
面 的 。* 

















CD 我 并 不 是 鼓励 后 端 开 发 者 越 姐 代 疱 , 只 是 建议 后 端 开发 者 略微 了 解 前 端的 搁 术 , 以 便于 在 大 型 工程 中 更 好 地 合作 。 
同时 当 没 有 前 端 开发 者 与 你 合作 的 时 候 ， 也 可 以 设计 出 不 至 于 太 难 看 的 页 面 。 
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作为 后 端 开 发 者 ， 你 可 能 和 我 一 样 都 不 太 擅 长 设计 , 不 过 没关系 ,我们 可 以 利用 已 有 的 
优秀 设计 。 如 果 你 认同 Twitter 的 简洁 风格 ， 那 么 Twitter Bootstrap 是 最 好 的 选择 。Twitter 
Bootstrap 是 由 Twitter 的 设计 师 和 工程 师 发 起 的 开源 项 目 ， 它 提供 了 一 套 与 Twitter 风格 一 致 
的 简洁 、 优 雅 的 Web UI， 包 含 了 完全 由 HTML, CSS, JavaScript 实现 的 用 户 交互 工具 。 不 
管 你 是 资深 的 前 端 工 程 师 , 还 是 专业 的 后 端 开 发 者 , 你 都 可 以 轻松 地 使 用 Twitter Bootstrap rtl 
作出 优美 的 界面 。 图 5-8 是 Twitter Bootstrap 部 件 的 介绍 页 面 。 








E components - Twitter Boot 


Aa 


和 CQ ff Q twitter.github.com/bootstrap/components.html Yrs Rd EN 


Components 


Dozens of reusable components are built into Bootstrap to provide navigation, alerts, popovers, and much 
more. 


Buttons Navigation Labels Badges Typography Thumbnails Alerts Progress bars Miscellaneous 


Button grOUupS voin buttons for more toolbar-like functionality 


Button groups Default example Checkbox and radio flavors 
Use button groups to join multiple buttons together ^ Here's how the HTML looks for a standard button Button groups can also function as radios, where 
as one composite component. Build them with a group built with anchor tag buttons: only one button may be active, or checkboxes, 
series of «a» or «button» elements. where any number of buttons may be active. View 
Left Middle Right the Javascript docs for that. 
Best practices 
We recommend the following guidelines for using <div class="btn-group"> Get the javascript » 
button groups and toolbars: <button class="btn">1</button> 
m «button class-"btn"»2«/button» Dropdowns in button groups 
* Always use the same element in a single St : 
bution group, [E or (OR) <button class="btn">3</button> Buttons with dropdowns must be 
</div> individually wrapped in their own .btn-group 


es Don't mix buttons of different colors in the 


same button group. within a .btn-toolbar for proper rendering. 





[5-8 Twitter Bootstrap 


5.5.4 使 用 Bootstrap 


现在 我 们 就 用 Bootstrap FRIFRI- Mhttp://twitter.github.com/bootstrap/ F Zi 
bootstrap.zip， 解 压 后 可 以 看 到 以 下 文件 : 


css/bootstrap-responsive.css 
css/bootstrap-responsive.min.css 
css/bootstrap.css 
css/bootstrap.min.css 
img/glyphicons-halflings-white.png 
img/glyphicons-halflings.png 
js/bootstrap.js 
js/bootstrap.min.js 
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其 中 所 有 的 JavaScript 和 CSS 文件 都 提供 了 开发 版 和 产品 版 ， 前 者 是 原始 的 代码 ， 后 者 
经 过 压缩 ， 文 件 名 中 市 有 min。 将 img 目录 复制 到 工程 public 目录 下 ,将 bootstrap.css、 
bootstrap-responsive.css 复制 到 public/stylesheets 中 ， 将 bootstrap.js 复制 到 public/javascripts H 
录 中 ， 然 后 从 http:/jquery.comy/ 下 载 一 份 最 新 版 的 jquery.js 也 放 人 public/javascripts 目录 中 。 





接 下 来 ， 修 改 views/layout.ejs: 





<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.o0org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 














«html» 
«head» 


«title»«$- title %> - Microblog«/title» 


«link rels'stylesheet' href-2'/stylesheets/bootstrap.css' /> 


«style type="text/css"> 
body { 
padding-top: 60px; 
padding-bottom: 40px; 
j 
</style> 
<link href="stylesheets/bootstrap-responsive.css" 
</head> 
<body> 


<div class="navbar navbar-fixed-top"> 
<div class="navbar-inner"> 


<div class="container"> 


rel="stylesheet" > 


<a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse"> 





<span class="icon-bar"></span> 

<span class="icon-bar"></span> 

<span class="icon-bar"></span> 
</a> 


<a class="brand" href="/">Microblog</a> 
<div class="nav-collapse"> 


<ul class="nav" > 


<li class="active"><a href="/"> 首 页 </a></1i> 


<li><a href="/login"> 登 入 </a></1i> 


<li><a href-"/reg"»;£JWh«/a»«/li» 





</ul> 
</div> 
</div> 
</div> 


</div> 


<div id="container" class="container"> 


<%- body %> 
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<hr /> 
<footer> 
<p><a href="http://www.byvoid.com/" target-" blank"»BYVoid«/a» 2012«/p» 
«/footer» 
«/div» 

</body> 

<script src="/javascripts/jquery.Js"></script> 

<script src="/javascripts/bootstrap.Js"></script> 

</html> 


上 面 代 码 是 使 用 Bootstrap 部 件 实 现 的 一 个 简单 页 面 框 架 , 整个 页 面 分 为 项 部 工具 栏 、 正 
文 和 页 脚 三 部 分 ， 其 中 正文 和 页 脚 包 含 在 名 为 container HJ aiv 标签 中 。 
最 后 我 们 设计 首页 ， 修 改 views/index.ejs: 


«div class-"hero-unit"» 
<hL> 欢 迎 来 到 Microblog«/h1» 
«p»Microblog 是 一 个 基于 Node.js 的 微 博 系统 。</P> 
«p» 
«a class="btn btn-primary btn-large" href-"/login"'» E X«/a» 
«a class="btn btn-large" href-z"/reg"» Bp; </a> 
«/p» 
«/div» 


«div class-"row"» 
«div class-"span4"'» 
«h2»Carbo 说 </h2> 
<p> 东 风 破 早 梅 向 暖 一 枝 开 冰雪 无 人 见 春 从 天 上 来 </P> 
«/div» 
«div class-"span4"» 
«h2»BYVoid 说 </h2> 
<p> 
Open Chinese Convert (OpenCC) 是 一 个 开源 的 中 文 简 繁 转换 项 目 ， 
致力 于 制作 高 质量 的 基于 统计 预料 的 简 繁 转 换 词 库 。 
还 提供 函数 库 (Libopencc)、 命 令 行 简 繁 转 换 工 具 、 人 工 校对 工具 、 词 典 生成 程序 、 
在 线 转换 服务 及 图 形 用 户 界 面 。</D> 
«/div» 
«div class-"span4"'» 
<h2> 佛 振 说 </h2> 
<D> 中 州 韵 输入 法 引擎 /Rime Input Method Engine 取 意 历史 上 通行 的 中 州 韵 ， 
愿 写 就 一 部 汇集 音韵 学 智慧 的 输入 法 经 典 之 作 。 
项 目 网 站 设 在 http://code.google.com/p/rimeime/ 
创造 应 用 价值 是 一 方面 ， 更 要 坚持 对 好 技术 的 追求 ， 布 望 能 写 出 灵动 而 易于 扩展 的 代码 ， 
使 其 成 为 一 款 个 性 十 足 的 开源 输入 法 。</p> 
</div> 


</div> 
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首页 的 效果 如 图 5-9 所 示 。 


国 Express - Microblog 


c Q 省 |(127.0.0.1:3000 TY EN 


Microblog 5 


欢迎 来 到 Microblog 


Microblog 是 一 个 基于 Node.js 的 微 博 系统 。 


Carbo 说 BYVoid 说 佛 振 说 
东风 破 早 梅 向 暖 一 枝 开 永 雪 无 人 见 春 从 天 上 来 Open Chinese Convert (OpenCC) 是 一 个 开源 的 中 中 州 韵 输入 法 引擎 / Rime Input Method Engine WE 
文 简 繁 转换 项 目 ， 致力 于 制作 高 质量 的 基于 统计 预 ”历史 上 通行 的 中 州 韵 ， 愿 写 就 一 部 汇集 音韵 学 智慧 
料 的 简 繁 转换 词 库 。 还 提供 函数 库 (ibopencc)、 命 的 输入 法 经 典 之 作 。 项 目 网 站 设 在 
倒 行 简 繁 转换 工具 、 人 工 校对 工具 、 词 典 生 成 程序 、 http://code.google.com/p/rimeime/ 创造 应 用 价值 是 
在 线 转换 服务 及 图 形 用 户 界 面 。 一 方面 ， 更 要 坚持 对 好 技术 的 追求 ， 希 苟 能 写 出 灵动 
而 易于 扩展 的 代码 ， 使 其 成 为 一 款 个 性 十 足 的 开源 
输入 法 。 
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图 $-9 ”使 用 Bootstrap 实现 的 首页 
怎么 样 ? 即使 不 展 设 计 也 做 出 了 优雅 的 界面 ， 使 用 Bootstrap 可 以 大 大 人 简化 前 端 设计 
工作 。 
5.6 用户 注 册 和 登录 


在 上 一 市 我 们 使 用 Bootstrap 创建 了 网 站 的 基本 框架 。 在 这 一 市 我 们 要 实现 用 户 会 话 的 
功能 ,包括 用 户 注 册 和 登录 状态 的 维护 。 为 了 实现 这 些 功 能 ,我们 需要 引入 会 话机 制 来 记录 
用 户 状态 ， 还 要 访问 数据 库 来 保存 和 读 取 用 户 信息 。 现 在 就 让 我 们 从 数据 库 开 始 。 





5.6.1 访问 数据 库 


我 们 选用 MongoDB 作为 网 站 的 数据 库 系 统 ， 它 是 一 个 开源 的 NoSQL 数据 库 ， 相 比 
MySQL 那样 的 关系 型 数据 库 ， 它 更 为 轻巧 、 灵 活 ， 非 第 适合 在 数据 规模 很 大 、 事 务 性 不 强 
的 场合 下 使 用 。 

1. NoSQL 

什么 是 NoSQL 呢 ? 为 了 解释 清楚 ， 首 先 让 我 们 来 介绍 儿 个 概念 。 在 传统 的 数据 库 中， 
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数据 库 的 格式 是 由 表 (table), íf (row) FR (field) 组 成 的 。 表 有 固定 的 结构 ， 规 定 了 
每 行 有 哪些 字段 ， 在 创建 时 被 定义 ， 之 后 修改 很 困难 。 行 的 格式 是 相同 的 ， 由 寿 干 个 固定 的 
字段 组 成 。 每 个 表 可 能 有 香干 个 字段 作为 索引 (index )， 这 其 中 有 的 是 主键 (primary key ), 
用 于 约束 表 中 的 数据 ， 还 有 唯一 键 (unique key )， 确 保 字段 中 不 存放 重复 数据 。 表 和 表 之 间 
可 能 还 有 相互 的 约束 ， 称 为 外 键 〈foreign key )。 对 数据 库 的 每 次 查询 都 要 以 行为 单位 ， 复 杂 
的 查询 包括 般 套 查询 、 连 接 查询 和 交叉 表 查 询 。 

拥有 这 些 功能 的 数据 库 被 称 为 关系 型 数据 库 ， 关 系 型 数据 库 通 常 使 用 一 种 叫做 SQL 
( Structured Query Language ) 的 查询 语言 作为 接口 ， 因 此 叉 称 为 SQL 数据库。 典型 的 SQL Že 
据 库 有 MySQL、Oracle、Microsoft SQL Server、PostereSQL、SQLite， 等 等 。 

NoSQL 是 1998 年 被 提出 的 , 它 曾 经 是 一 个 轻 量 、 开 源 、 不 提供 SQL 功能 的 关系 数据 库 。 
但 现在 NoSQL 被 认为 是 NotOnly SQL 的 简称 ， 主 要 指 非 关 系 型 、 分 布 式 、 不 提供 ACID 的 
数据 库 系统 。 正 如 它 的 名 称 所 暗示 的 ，NoSQL 设计 初 谚 并 不 是 为 了 取代 SQL 数据 库 的 ， 而 
是 作为 一 个 补充 ， 它 和 SQL 数据 库 有 着 各 上 自 不 同 的 适应 领域 。NoSQL 4f& SQL 数据库 一 样 
都 有 着 统一 的 架构 和 接口 ， 不 同 的 NoSQL 数据 库 系 统 从 里 到 外 可 能 完全 不 同 。 

2. MongoDB 

MongoDB 是 一 个 对 象 数 据 库 ， 它 没有 表 、 行 等 概念 ， 也 没有 固定 的 模式 和 结构 ， 所 有 
的 数据 以 文档 的 形式 存储 。 所 谓 文档 贺 是 一 个 关联 数组 式 的 对 象 , 它 的 内 部 由 属性 组 成 , 一 
个 属性 对 应 的 值 可 能 是 一 个 数 、 字 符 串 、 日 期 、 数 组 ， 甚 至 是 一 个 通 套 的 文档 。 下 面 是 一 个 
MongoDB 文档 的 示例 : 






































( " id" : Objectid( "4£7fe8432b4a1077a7c551e8" ), 
"uid" : 2004, 


"username" : "byvoid", 
"net9" : { "nickname" : "BYVoid", 
"surname" : "Kuo", 
"givenname" : "Carbo", 
"fullname" : "Carbo Kuo", 
"emails" : [ "byvoid@byvoid.com", "byvoid.kcp@gmail.com" ], 
"website" : "http://www.byvoid.com", 
"address" : "Zijing 2#, Tsinghua University" } 


j 

上 面 文档 中 uia 是 一 个 整数 属性 ，username 是 字符 串 属性 ，_iq 是 文档 对 象 的 标识 
符 ， 格 式 为 特定 的 objectIdq。net9 是 一 个 藤 套 的 文档 ， 其 内 部 结构 与 一 般 文 档 无 异 。 从 
格式 来 看 文档 好 像 JSON, i, MongoDB 的 数据 格式 就 是 JSON “， 因 此 与 JavaScript 的 








(D ACID 是 数据 库 系 统 中 事务 (transaction ) 所 必须 具备 的 四 个 特性 ， 即 原子 性 ( atomicity )、 一 致 性 ( consistency )、 
隔离 性 isolation) 和 持久 性 ( durability )。 
D 准确 地 说 ，MongoDB 的 数据 格式 是 BSON (Binary JSON )， 它 是 JSON 的 一 个 扩展 。 
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杀 和 性 很 强 。 在 Mongodb 中 对 数据 的 操作 都 是 以 文档 为 单位 的 ， 当 然 我 们 也 可 以 修改 文档 
的 部 分 属性 。 对 于 查询 操作 , 我 们 只 需要 指定 文档 的 任何 一 个 属性 ， 就 可 在 数据 库 中 将 满足 
条 件 的 所 有 文档 筛选 出 来 ,为 了 加 快 查 询 , MongoDB 也 对 文档 实现 了 索引 , 这 一 点 和 SQL 数 
据 库 一 样 。 

3. 连接 数据 库 

现在 ， 主 我 们 来 看 看 如 何 连 接 数 据 库 吧 。 首 先 确 保 已 在 本 地 安 猴 好 了 MongoDB， 如 果 
没有 ， 请 去 http://www.mongodb.org/ 查 看 如 何 安 装 。 

H TÆ Node.js 中 使 用 MongoDB ,我们 需要 获取 一 个 模块 ,打开 工程 目录 中 的 package.json， 
在 dependencies 属性 中 添加 一 行 代 码 : 


{ 
"name": "microblog" 
"version": "0.0.1" 


"private": true 





"dependencies": { 
"express": "2.5.8" 
p tejs": ">s 0:041" 


, "mongodots ">s 0.9.9" 5 
J 


} 


然后 运行 npm install 更 新 依赖 的 模块 。 接 下 来 在 工程 的 目录 中 创建 settings.js 文件 ， 
这 个 文件 用 于 保存 数据 库 的 连接 信息 。 我 们 将 用 到 的 数据 库 命 名 为 microblog， 数 据 库 服务 
佛 在 本 地 ， 因 此 Settings.js 文 件 的 内 容 如 下 : 


module.exports = { 
CookieSecret: 'microblogbyvoid', 
db: 'microblog', 
host: 'localhost', 

HM 


HF, do 是 数据 库 的 名 称 ，host 是 数据 库 的 地 址 。cookieSecret 用 于 Cookie 加 密 与 数 


据 库 无 关 ， 我 们 留 作 后 用 。 
接 下 来 在 models 子 目 录 中 创建 db.js， 内 容 是 : 


var settings = require('../settings'); 
var Db - require('mongodb').Db; 
var Connection - require('mongodb').Connection; 


var Server - require('mongodb').Server; 


module.exports - new Db(settings.db, new Server(settings.host, Connection.DEFAULT 
PORT, {})); 
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以 上 代码 通过 module.exports 输出 了 创建 的 数据 库 连 接 , 在 后 面 的 小 市 中 我 们 会 用 
到 这 个 模块 。 由 于 模块 只 会 被 加 载 一 次 ， 以 后 我 们 在 其 他 文件 中 使 用 时 均 为 这 一 个 实例 。 


5.6.2 会话 支持 


在 完成 用 户 注册 和 登录 功能 之 前 , 我 们 需要 和 完了 解 会 话 的 概念 。 会话 是 一 种 持久 的 网 络 
协议 ， 用 于 完成 服务 硕 和 客户 奖 之 间 的 一 些 交 互 行 为 。 会 话 是 一 个 比 连接 粒度 更 大 的 概念 ， 
一 次 会 话 可 能 包含 多 次 连接 ,每 次 连接 都 被 认为 是 会 话 的 一 次 操作 。 在 网 络 应 用 开发 中 , 有 
必要 实现 会 话 以 帮助 用 户 交 互 。 例 如 网 上 购物 的 场景 ， 用户 浏览 了 多 个 页 面 ， 购 天 了 一 些 物 
品 , 这 些 请 求 在 多 次 连接 中 完成 。 许 多 应 用 层 网 络 协议 都 是 由 会 话 文 持 的 , 如 FTP、Telnet 等 ， 
而 HTTP 协 议 是 无 状态 的 ， 本 里 不 文 持 会 话 ， 因 此 在 没有 和 额外 手段 的 帮助 下 ， 前 面 场景 中 服 
务 箱 不 知道 用 户 购 灭 了 什么 。 

为 了 在 无 状态 的 HTTP 协议 之 上 实现 会 话 ，Cookie 诞生 了 。Cookie 是 一 些 存 储 在 客户 
半 的 信息 ， 每 次 连接 的 时 候 由 浏览 硕 回 服务 硕 递 灾 ， 服 务 希 也 回 浏 览 硕 发 起 仓 储 Cookie 的 
请 求 , 依 徘 这 样 的 手段 服务 带 可 以 识别 客户 端 。 我 们 通常 意义 上 的 HTTP 会 话 功能 就 是 这 样 
实现 的 。 具体 来 说 , 浏览 器 首次 回 服 务 器 发 起 请 求 时 ， 服 务 需 生成 一 个 唯一 标识 符 并 发 送 给 
客户 请 浏 览 希 ， 浏 览 融 将 这 个 唯一 标识 符 存 储 在 Cookie 中 ， 以 后 每 次 再 发 起 请 求 ， 客 户 端 
浏览 硕 都 会 回 服务 硕 传 送 这 个 唯一 标识 符 ， 服 务 天 通过 这 个 唯一 标识 符 来 识别 用 户 。 

对 于 开发 者 来 说 , 我 们 无 须 关 心 浏览 硕 端 的 存储 ， 需 要 关注 的 仅仅 是 如 何 通过 这 个 唯一 
标识 符 来 识别 用 户 。 很 多 服务 闪 脚 本 语言 都 有 会 话 功能 , 如 PHP, 把 每 个 唯一 标识 符 存 储 到 
文件 中 。Express 也 提供 了 会 话 中 间 件 ， 默 认 情 次 下 是 把 用 户 信息 存储 在 内 存 中 ， 但 我 们 既 
然 已 经 有 了 MongoDB, 不 妨 把 会 话 信 息 存储 在 数据 库 中 ,便于 持久 维护 。 为 了 使 用 这 一 功 
能 ， 我 们 首先 要 获得 一 个 叫做 connect-mongo 的 模块 ， 在 package.json 中 添加 一 行 代码 : 


{ 






































"name": "microblog" 
"version": "0.0, ^ 


"private": true 





"dependencies": { 
.Q" 
"ejs": ">= 0.0.1" 


"express": "2. 


"connect-mongo": ">= 0.1.7" 
"mongodb": ">= 0.9.9" 
】 
】 


运行 npm install 获得 模块 。 然 后 打开 app.js， 添 加 以 下 内 容 : 


var MongoStore = require('connect-mongo!'); 


var settings - require('../settings'); 
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app.configure(function()( 

app.set('views', dirname + '/views'); 

app.set('view engine', 'ejs'); 
app.use(express.bodyParser()); 
app.use(express.methodOverride()); 
app.use(express.cookieParser()); 
app.use(express.session(( 

secret: settings.cookieSecret, 

store: new MongoStore(í 

db: settings.db 

j) 
E) 
app.use(app.router); 
app.use(express.static(  dirname + '/public')); 


Wa 


其 中 express.cookieParser() 是 Cookie 解析 的 中 间 件 。express.session() 则 
提供 LAW X, 设置 它 的 store 参数 为 MongoStore 实例 ， 把 会 EA A 
以 避免 丢失 。 

在 后 面 的 小 节 中 ， 我 们 可 以 通过 reg.session 获取 当前 用 户 的 会 话 对 象 ， 以 维护 用 
户 相关 的 信息 。 





5.6.3 ”注册 和 登入 


我 们 已 经 准备 好 了 数据 库 访 问 和 会 话 存储 的 相关 信息 , 接 下 来 开始 实现 网 站 的 第 一 个 功 
能 ， 用 户 注册 和 登入 。 

1. 注册 页 面 

首先 来 设计 用 户 注册 页 面 的 表单 ， 创 建 views/reg.ejs 文件 ， 内 容 是 


<form class-"form-horizontal" method-"post"» 
«fieldset» 
«legend» Ħ F ;zJ«/legend» 
«div class-"control-group"» 
«label class-"control-label" for-"username"»ff P £«/label» 
«div class-"controls"» 
«input type="text" class-"input-xlarge" id-"username" name-"username"» 
«p class="help-block"> 你 的 账户 名 称 ， 用 于 登录 和 显示 。</p> 
</div> 
</div> 
<div class="control-group"> 
«label class-"control-label" for="password"> 口 邻 </label> 
<div class="controls"> 
«input type-"password" class-"input-xlarge" id-"password" name-"password"» 


«/div» 
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</div> 

<div class="control-group"> 
«label class-"control-label" for-"password-repeat"» € 4 AXu4«/label» 
«div class-"controls"» 

«input type-"password" class-"input-xlarge" id-"password-repeat" 
name-"password-repeat"» 

</div> 

</div> 

«div class="form-actions"> 
<button type="submit" class="btn btn-primary" > H </button> 

</div> 

</fieldset> 
</form> 


这 个 表单 中 有 3 个 输入 单元 ， 分 别 是 username. password 和 password-repeat。 
表单 的 请 求 方法 是 POST， 将 会 发 送 到 相同 的 路 径 下 。 

到 目前 为 止 我 们 所 有 的 路 由 规则 还 都 写 在 了 appjs 中 ， 随 着 规模 扩大 其 维护 难度 不 断 提 
高 ， 因 此 我 们 需要 把 所 有 的 路 由 规则 分 离 出 去 。 修 改 appjjs 的 app.configure 部 分 ， 用 


app.use(express.router(routes)) 代替 app.use(app.router): 








app.configure(function()( 


app.set('views', --dirname + '/views!'); 
app.set('view engine', 'ejs'); 
app.use(express.bodyParser()); 


express.cookieParser()); 


( 

( 
app.use(express.methodOverride()); 
app.use( 

( 


app.use(express.session(( 

Secret: settings.cookieSecret, 

store: new MongoStore(í 

db: settings.db 

j) 
1223 
app.use(express.router(routes)); 
app.use(express.static(--dirname + '/public')); 


}); 


接 下 来 打开 routes/index.js， 把 内 容 改 为 : 





module.exports = function(app) { 
app.get('/', function(í(reg, res) { 
res.render('index', { 
title: ' 首 页 ' 
i13 
ii: 
app.get('/reg', function(regd, res) { 





res.render('reg', { 
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title: "HPF ERG 
Jug 
jg 
53 


JüfEiSTT appjs, ÆN) s HITI http://localhost:3000/reg， 可 以 看 到 如 图 5-10 所 示 的 


国 用 户 注册 - Microblog 


€ Q f (127.0.0.1:3000/reg w ~ 
Microblog ED 
用 户 注 册 
用 户 名 


你 的 账户 的 名 称 ， 用 于 登录 和 显示 。 


口令 


重复 输入 口 全 





BYVoid 2012 





图 $-10 ”注册 页 面 的 效果 


2. HERR Iz 

上 面 这 个 页 面 十 分 简洁 优 雅 , 看 了 以 后 是 不 是 有 立即 注册 的 冲动 呢 ” 当 然 , 现在 点 击 注 
册 是 没有 效果 的 ， 因 为 我 们 还 没有 实现 POST 请 求 发 送 后 的 功能 ， 下 面 就 来 实现 。 在 routes/ 
index.js 中 添加 /reg 的 POST llf PRAE: 











app.post('/reg', function(reg, res) ( 
// 检 验 用 户 两 次 输入 的 口令 是 否 一 致 
if (req.body['password-repeat'] != req.body['password']) { 
req.flash('error', ' 两 次 输入 的 口 邻 不一致: ) ; 


return res.redirect('/reg!'); 


} 
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// 生 成 口令 的 散 列 值 
var md5 = crypto.createHash('mdb'); 
var password = mdb5.update(req.body.password).digest('base64'); 


var newUser = new User(( 
name: req.body.username, 
password: password, 


124 


/ /检查 用 户 名 是 否 已 经 存在 


User.get (newUser.name, function(err, user) { 





if (user) 

err - 'Username already exists.'; 
if (err) { 

req.flash('error', err); 





return res.redirect('/reg'); 
j 
// 如 果 不 存在 则 新 增 用 户 
newUser.save(function(err) ( 
if (err) { 
req.flash('error', err); 





return res.redirect('/reg'); 
] 


req.session.user E newUser; 
reg.flash('success', WRA J; 
res.redirect('/'); 
43 
}); 

}); 

这 有 段 代码 用 到 了 一 些 新 的 东西 ， 我 们 一 一 说 明 。 

O regq.body 就 是 POST 请 求 信 息 解 析 过 后 的 对 象 ， 例 如 我 们 要 访问 用 户 传递 的 
password WAJA, HEW] req.body['passwora'] 即 可 。 

口 reg.flash 是 Express 提供 的 一 个 奇妙 的 工具 ， 通 过 它 保存 的 变量 只 会 在 用 户 当 前 
和 下 一 次 的 请 求 中 被 访问 , 之 后 会 被 清除 , 通过 它 我 们 可 以 很 方便 地 实现 页 面 的 通知 
和 错误 信息 显示 功能 。 

O res.redirect 是 重 定 癌 功 能 ， 通 过 它 会 同 用 户 返 回 一 个 303 See Other 状态 ， 通 知 
浏览 硕 转 回 相 应 页 面 。 

O crypto 是 Node.js 的 一 个 核心 模块 ， 功 能 是 加 密 并 后 成 各 种 散 列 ， 使 用 它 之 前 首先 
要 声明 var crypto = require('crypto')。 我 们 代码 中 使 用 它 计算 了 密码 的 散 
列 值 。 

D User 是 我 们 设计 的 用 户 对 象 ， 在 后 面 我 们 会 详细 介绍 ， 这 里 先 假设 它 的 接口 都 是 可 
用 的 ， 使 用 前 需要 通过 var User = require('../models/user.js') 引用 。 
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O User.get 的 功能 是 通过 用 户 名 获取 已 知 用 户 ， 在 这 里 我 们 判断 用 户 名 是 否 已 经 存 
在 。User .save 可 以 将 用 户 对 象 的 修改 写 和 信 数据库。 
口 通过 req.session.user = newUser 问 会 话 对 象 瑟 人 了 当前 用 户 的 信息 ， 在 后 面 
我 们 会 通过 它 判 断 用 户 是 否 已 经 登录 。 
3. APARA 
在 前 面 的 代码 中 ， 我 们 直接 使 用 了 User 对 象 。User 是 一 个 描述 数据 的 对 象 ， 即 MVC 
架构 中 的 模型 。 前 面 我 们 使 用 了 许多 视图 和 控制 希 ,， 这 是 第 一 次 接触 到 模型 。 与 视图 和 控制 
顺 不 同 ， 模 型 是 真正 与 数据 打交道 的 工具 ,没有 模型 ， 网 站 就 只 是 一 个 外 壳 , 不 能 发 挥 真 实 
的 作用 ， 因 此 它 是 框架 中 最 根本 的 部 分 。 现 在 就 让 我 们 来 实现 User RAME, 
在 models 目录 中 创建 userjs 的 文件 ， 内 容 如 下 : 














var mongodb = require('./db'); 


function User(user) { 
this.name - user.name; 
this.password - user.password; 
i3 


module.exports - User; 





User.prototype.save = function save(callback) ( 
// A Mongodb 的 文档 
var user = ( 
name: this.name, 
password: this.password, 
Hi 
mongodb.open(function(err, db) ( 
if (err) i 
return callback(err); 
j 
// 读 取 users 集合 
db.collection('users', function(err, collection) ( 
if (err) i1 
mongodb.close(); 
return callback(err); 
} 
// 为 name 属性 添加 索引 
collection.ensureIndex('name', íunique: true}); 
// SX user 文档 
collection.insert(user, (safe: true}, function(err, user) ( 
morgodb.close(); 
callback(err, user); 
33 3 
JIJ 
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User.get = function get (username, callback) { 
mongodb.open(function(err, db) ( 
if (err) ( 
return callback(err); 
j 
// 读 取 users 集合 
db.collection('users', function(err, collection) 1 
if (err) { 
mongodb.close(); 
return callback(err); 
j 
// 查找 name 属性 为 username 的 文档 
collection.findOne((name: username}, function(err, doc) ( 


mongodb.close(); 


if (doc) 1 
// 封装 文档 为 User 对 象 
var user = new User(doc); 


callback(err, user); 


[UND 


else ( 


callback(err, null); 


以 上 代码 实现 了 两 个 接口 ，User .prototype.save 和 User.get， 前 者 是 对 象 实例 
的 方法 ， 用 于 将 用 户 对 象 的 数据 保存 到 数据 库 中 ,后 者 是 对 象 构造 水 数 的 方法 ， 用 于 从 数据 
库 中 查找 指定 的 用 户 。 

4. 视图 交互 

现在 几乎 已 经 万 事 俱 备 , 只 差 视 图 的 支持 了 。 为 了 实现 不 同 登 录 状 态 下 页 面 呈 现 不 同 内 
容 的 功能 ， 我 们 需要 创建 动态 视图 助手 ， 通 过 它 我 们 才能 在 视图 中 访问 会 话 中 的 用 户 数 据 。 
同时 为 了 显示 错误 和 成 功 的 信息 ， 也 要 在 动态 视图 助手 中 增加 啊 应 的 师 数 。 

打开 app.js， 添 加 以 下 代码 : 











app.dynamicHelpers(t 
user: function(regq, res) { 
return req.session.user; 
Fa 
error: function(regd, res) { 


var err - reg.flash('error'); 
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if (err.length) 
return err; 
else 
return null; 
Fy 
success: function(req, res) ( 
var succ - req.flash('success'); 
if (succ.length) 
return Succ; 
else 
return null; 
m 
Hl): 


接 下 来 ， 修 改 layout.ejs 中 的 导航 栏 部 分 : 


sul class="nav"> 
<li class="active"><a href="/"> 首 页 </a></1i> 
<% if (luser) { %> 
<li><a href="/login">ğA</a></li> 
<li><a href="/reg">;ŁżğH</a></li> 5 
<% ) else ( $- 
<li><a href-"/logout"»4$ HH «/a»«/li-» 
<3% } 和 > 


</ul> 


上 面 功能 是 为 已 登 人 用 户 和 未 登入 用 户 显 示 不 同 的 信息 。 在 container 中 , <3- body %> 
之 前 加 入 : 


<% if (success) { 各 > 
«div class-"alert alert-success"-» 
<%= success $-» 
</div> 
<% } $5 
<% if (error) { %> 
<div class="alert alert-error"> 
<%= error %> 
</div> 


<% } $ 


它 的 功能 是 页 面 通知 。 
现在 看 看 最 终 的 效 琳 吧 ， 图 5-11 和 图 5-12 分 别 古 
Ilt RT 。 


主 册 时 过 到 错误 和 注册 成 功 以 后 的 


一 <v 
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国 用 户 注册 - Microblog 
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用 户 注 册 
APZ byvoid 
你 的 账户 的 名 称 ， 用 于 登录 和 显示 。 
口令 
重复 输入 口令 
注册 
BYVoid 2012 
y e ps NEN 
图 5-11 两 次 输入 的 密码 不 一 臻 
国 首 页 - Microblog 
c Q f$ | Q 127.0.0.1:3000 rs - 
Microblog 5m 
注册 成 功 
"WES 
Carbo 说 BYVoid 说 佛 振 说 
东风 破 早 梅 向 暖 一 枝 开 冰雪 无 人 见 春 从 天 上 来 Open Chinese Convert (OpenCC) 是 一 个 开源 的 中 中州 韵 输入 法 引擎 / Rime Input Method Engine RÆ 
文 简 繁 转换 项 目 ， 致力 于 制作 高 质量 的 基于 统计 预 ”历史 上 通行 的 中 州 韵 ， 愿 写 就 一 部 汇集 昔 韵 学 智慧 
料 的 简 繁 转换 词 库 。 还 提供 本 数 库 (ibopencc)、 命 的 输入 法 经 典 之 作 。 项 目 网 站 设 在 
兮 行 简 繁 转 换 工 具 、 人 工 校对 工具 、 词 典 生成 程序 、 http://code.google.com/p/rimeime/ 创造 应 用 价值 是 
在 线 转换 服务 及 图 形 用 户 界 面 。 一 方面 ， 更 要 坚持 对 好 技术 的 追求 ， 希 蔚 能 写 出 灵动 
而 易于 扩展 的 代码 ， 使 其 成 为 一 款 个 性 十 足 的 开源 
输入 法 。 
BYVoid 2012 





图 $-12 ”注册 成 功 


5.6 “用户 注册 和 登录 119 


5. 登入 和 登 出 
当 我 们 完成 用 户 注册 的 功能 以 后 ,再 实现 用 户 登 和 和 登 出 就 相当 容易 了 。 把 下 面 的 代码 
加 到 routes/index.js 中 : 





app.get('/login', function(reg, res) ( 
res.render('login', { 
title: ' 用 户 登 入 '， 
FI? 
yj 





app.post('/login', function(reqg, res) ( 
// 生 成 口令 的 散 列 值 
var md5 = crypto.createHash('mdb'); 
var password = md5.update(req.body.password).digest('base64'); 


User.get(req.body.username, function(err, user) { 





if (!user) { 
reg.flash('error', "MPTA 
return res.redirect('/login'); 

j 

if (user.password !- password) ( 
req.flash('error', 'fH&u4&iX'); 
return res.redirect('/login'); 

j 

req.session.user - user; 

req.flash('success', CEARD] 

res.redirect('/'); 

))1 
J)a 











app.get('/logout', function(req, res) { 
req.session.user = null; 
req.flash('success', 'Z um»); 
res.redirect('/'); 


J)o 


在 这 里 你 可 以 清晰 地 看 出 登入 和 登 出 仅仅 是 rea.session.user BÆRERE, JEA faj 
单 。 但 这 会 不 会 有 安全 性 问题 呢 ? 不 会 的 ， 因 为 这 个 变量 只 有 服务 端 才 能 访问 到 ， 只 要 不 是 
尘 客 攻破 了 整个 服务 项 ， 无 法 从 外 部 改动 。 

最 后 我 们 创建 views/login.ejs， 内 容 如 下 : 





<form class-"form-horizontal" method-"post"» 
«fieldset» 
«legend» Ħ P $4 X«/legend» 
«div class-"control-group"'» 
«label class-"control-label" for-"username"»ff P £«/label» 
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«div class-"controls"» 
«input type="text" class-"input-xlarge" id-"username" name-"username"» 
</div> 
</div> 
<div class="control-group"> 
«label class-"control-label" for="password"> 口 邻 </label> 
<div class="controls"> 
«input type="password" class-"input-xlarge" id-"password" name-"password"» 
</div> 
</div> 
<div class="form-actions"> 
<button type="submit" class="btn btn-primary ">%A</button> 
</div> 
</fieldset> 
</form> 


EN Jd 2s PY Phttp:/localhost:3000/login, jf sa 5-13 所 示 的 页 面 。 


国 用 户 登 入 - Microblog 


c— Q 省 | @ 127.0.0.1:3000/login 让 EN 
Microblog 首页 登 
用 户 登入 
用 户 名 
口令 


BYVoid 2012 





图 5-13 ”用 户 登 入 
至 此 用 户 注 册 和 登录 的 功能 就 完全 实现 了 。 





5.6.4 ”页面 权 限 控制 
在 前 面 我 们 已 经 实现 了 用 户 登 入 , 并 且 在 页 面 中 通过 不 同 的 内 容 反 映 出 了 用 户 已 登入 和 
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未 登入 的 状态 。 现 在 我 们 还 有 一 个 工作 要 做 ,就 是 为 页 面 设 置 访问 权限 。 例如 ， 登 出 功能 应 
该 只 对 已 登入 的 用 户 开放 , 注册 和 登入 页 面 则 应 该 阻止 已 登入 的 用 户 访 问 。 如 何 实现 这 一 点 
呢 ? 最 人 简单 的 方法 是 在 每 个 页 面 的 路 由 啊 应 函数 内 检查 用 户 是 否 已 经 登录 , 但 这 会 市 来 很 多 
重复 的 代码 ， 违 反 了 DRY “原则 。 因 此， 我 们 利用 路 由 中 间 件 来 实现 这 个 功能 。 

5.3.5 万 介绍 了 同一 路 径 绑 定 多 个 啊 应 函数 的 方法 , 通过 调用 next () 转移 控制 权 , 这 种 
方法 叫做 路 由 中 间 件 。 我 们 可 以 把 用 户 登 和 人 状态 检查 放 到 路 由 中 间 件 中 , 在 每 个 路 径 前 增加 
路 由 中 间 件 ， 即 可 实现 页 面 权限 控制 。 

最 终 的 routes/index.js 内 容 如 下 : 














NN 














var crypto = require('crypto!'); 
var User - require('../models/user.js'); 


module.exports - function(app) ( 
app.get('/', function(reqg, res) ( 
res.render('index', { 
title: “an 
ii 
i): 





app.get('/reg', checkNotLogin); 
app.get('/reg', function(reg, res) { 
res.render('reg', { 
title: "用 户 注册 , 
rJ 
23 





app.post('/reg', checkNotLogin); 


app.post('/reg', function(reqg, res) ( 
// 检 验 用 户 两 次 输入 的 口令 是 否 一 致 
if (req.body['password-repeat'] !- req.body['password']) ( 
req.flash('error', ' 两 次 输入 的 口令 不 一 致 : ); 


return res.redirect('/reg!'); 


} 





// 生 成 口令 的 散 列 值 
var md5 e crypto.createHash('md5'); 
var password = mdb5.update(req.body.password).digest('base64'); 


var newUser = new User(( 
name: req.body.username, 
password: password, 


im. 


(D DRY (Don't Repeat Yourself) 是 软件 工程 设计 的 一 个 基本 原则 ， 又 称 “ 一 次 且 仅 一 次 ”(Once And Only Once ), 
指 的 是 开发 中 应 该 避免 相同 意义 的 代码 重复 出 现 。 
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/ /检查 用 户 名 是 否 已 经 存在 


User.get (newUser.name, function(err, user) { 





if (user) 
err - 'Username already exists.'; 
if (err) { 
req.flash('error', err); 
return res.redirect('/reg'); 
j 
// 如 果 不 存 在 则 新 增 用 户 


newUser.save(function(err) { 





if (err) { 
req.flash('error', err); 





return res.redirect('/reg'); 


J 


req.session.user = newUser; 
reg.flash('success', "EWRJ' 3; 


res.redirect('/'); 





app.get('/login', checkNotLogin); 
app.get('/login', function(reg, res) { 
res.render('login', { 
title: ' 用 户 登 入 '， 
His 
I3 





app.post('/login', checkNotLogin); 


app.post('/login', function(reqg, res) { 
// 生 成 口令 的 散 列 值 
var md5 = crypto.createHash('mdb'); 


var password = md5.update(req.body.password).digest('base64'); 





User.get(req.body.username, function(err, user) { 

if (!user) { 
req.flash('error'，' 用 户 不 存在 '); 
return res.redirect('/login'); 

j 

if (user.password !- password) { 
reg.flash('error', ' 用 户口 令 错 误 '); 
return res.redirect('/login'); 

j 

req.session.user - user; 

req.flash('success', 'A&AJXRS'); 

res.redirect('/'); 


1233 











57 发 表 微 博 123 


app.getí('/logout', checkLogin):; 

app.get('/logout', function(reg, res) ( 
req.session.user - null; 
req.flash('success', 'AU A); 
res.redirect('/'); 


ps 





function checkLogin(req, res, next) { 
if (!req.session.user) ( 
red.flash('error', 'SA')s 
return res.redirect('/login'); 
j 
nextí); 


J 





function checkNotLogin(req, res, next) { 
if (req.session.user) { 
req.flash('error', 'EJAEA'); 
return res.redirect('/'); 
j 


next(); 





5.7 ERA 


现在 网 站 已 经 具备 了 用 户 注 册 、 登 入 、 页 面 权 限 控制 的 功能 ,这些 功 能 为 网 站 最 核心 的 
部 分 一 一 发 表 微 博 做 好 了 准备 。 在 这 个 小 节 里 ,我 们 将 会 实现 发 表 微 博 的 功能 ， 完 成 整个 网 
站 的 设计 。 


5.7.1 微 博 模型 
现在 让 我 们 从 模型 开始 设计 。 仿 照 用 户 模型 ， 将 微 博 模型 命名 为 Post 对 象 ， 它 拥有 与 


User 相似 的 接口 分 别 是 Post .get 和 Post .prototype.saveo。 POSLIOSL 的 功能 是 从 
数据 库 中 获取 微 博 , 可 以 按 指定 用 户 获 取 , 也 可 以 获取 全 部 的 内 容 。 Post .prototype.save 
是 Post 对 象 实例 的 方法 ， 用 于 将 对 象 的 变动 保存 到 数据 库 。 


创建 models/post.jjs， 写 人 以 下 内 容 : 











var mongodb = require('./db'); 


function Post (username, post, time) { 
this.user - username; 


this.post - post; 
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if (time) ( 
this.time - time; 
j else ( 
this.time - new Date(); 
j 
)i 


module.exports - Post;j 


Post.prototype.save = function save(callback) ( 
// 存 入 Mongodb 的 文档 
var post = ( 
user: this.user, 
post: this.post, 
time: this.time, 
H 
mongodb.open(function(err, db) { 
if (err) 1 
return callback(err); 
j 
// 读 取 posts 集合 
db.collection('posts', function(err, collection) 
if (err) 1 
mongodb.close(); 
return callback(err); 
j 
// 为 user 属性 添加 索引 
collection.ensureIndex('user'); 
//| 写 入 post 文档 


| 


collection.insert (post, {safe: true}, function(err, post) 


mongodb.close(); 


callback(err, post); 


Post.get = function get (username, callback) { 
mongodb.open(function(err, db) { 
if (err) i1 
return callback(err); 
j 
// 读 取 posts 集合 
db.collection('posts', function(err, collection) 
if (err) { 
mongodb.close(); 


return callback(err); 


i 
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a 


// 查找 user 属性 为 username 的 文档 ， 如 果 username Æ null 则 匹配 全 部 
var query = {}; 
if (username) { 
query.user - username; 
j 
collection.find(query).sort(([ítime: -1jJ).toArray(function(err, docs) { 
mongodb.close(); 
if (err) { 
callback(err, null); 
j 
// 封装 posts 为 Post 对 象 
var posts = []; 
docs.forEach(function(doc, index) ( 
var post = new Post(doc.user, doc.post, doc.time); 
posts.push(post); 
i); 
callback(null, posts); 





在 后 面 我 们 会 通过 控制 带 调 用 这 个 模块 。 


5.7.2 ”发 表 微 博 


我 们 曾经 约定 通过 POST 方法 访问 /post 以 发 表 微 博 ， 现 在 让 我 们 来 实现 这 个 控制 器 
在 routes/index.js 中 添加 下 面 的 代码 : 


app.post('/post', checkLogin); 
app.post('/post', function(reg, res) { 
var currentUser - req.session.user; 
var post - new Post(currentUser.name, req.body.post); 
post.save(function(err) { 
if (err) 1 
reg.rlash('error', err); 





return res.redirect('/'); 


] 
req.flash('success', THIRA) 
res.redirect('/u/' + ceurrentUser.name)s: 


I3 
E 


这 上 段 代码 通 通过 req.session.user 获取 当前 用 户 信息 ， 从 req.body.post 获取 用 
户 发 表 的 内 容 ， 建 立 Post 对 象 ， 调 用 save() 方法 存储 信息 ， 最 后 将 用 户 重 定 问 到 用 户 
W Iff a 
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5.7.3 MARHE 
用 户 页 面 的 功能 是 展示 用 户 发 表 的 所 有 内 容 ， 在 routes/index.js 中 加 入 以 下 代码 : 








app.get('/u/:user', function(í(reg, res) { 





User.get(req.params.user, function(err, user) { 
if (!user) { 
req.rlash('error', MPRA); 
return res.redirect('/'); 
j 


Post.get(user.name, function(err, posts) { 





if (err) i 
req.flash('error', err); 
return res.redirect('/'); 

] 


res.render('user', { 








title: user.name, 


posts: posts, 











CHIESE H Tots tr MP ETE, MRF RGE EPRA A, 最 后 通 
过 posts 属性 传递 给 user 视图 。views/user.ejs 的 内 容 如 下 : 


<% if (user) { %> 
( 1 


<%- partial('say') %$> 
<% } $- 
<%- partial('posts') 委 > 





根据 DRY 原则 , 我 们 把 重复 用 到 的 部 分 都 提取 出 来 , 分 别 放 入 say.ejs 和 posts.ejs。 say.ejs 
的 功能 是 显示 一 个 发 表 微 博 的 表单 ， 它 的 内 容 如 下 : 








<form method="post" action="/post" class="well form-inline center" style="text-align: 
center;"» 
«input type="text" class-"span8" name-"post"» 
«button type="submit" class="btn btn-success"»«i class-"icon-comment icon-white"» 
</i> AR à«/button» 
</form> 


posts.ejs 的 目的 是 按照 行列 显示 传人 的 posts 的 所 有 内 容 : 


<% posts.forEach(function(post, index) { 
if (index £ == 0) { 各 > 
«div class="row"> 
«$) $- 


<div class="span4"> 
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< 了 2><a href="/u/<%= postiuser %>"><%= post.user %></a> 说 </h2> 
«p»«small»«$- post.time $»5«/small»«/p» 


«p»«$- post.post %></p> 


</div> 
<% if (index % 3 == 2) { %> 
«/div»«!-- end row --> 


«$j)) $- 

<% if (posts.length $ 3 !- 0) ( $5 
«/div»«!-- end row --» 

«$j $- 








完成 上 述 工作 后 , EERI a. EHI B vtri E ACULA W, 然后 可 以 看 到 用 户 页 面 
的 效果 如 图 5-14 所 示 。 


byvoid - Microblog 


c CQ f (Q 127.0.0.1:3000/u/byvoid "ar A 


Microblog 5% 





byvoid 说 byvoid 说 byvoid 说 

Mon Apr 09 2012 20:21:11 GMT+0800 (CST) Mon Apr 09 2012 20:19:44 GMT--0800 (CST) Mon Apr 09 2012 20:18:58 GMT+0800 (CST) 
东风 破 早 梅 向 暖 一 枝 开 2KSBfRCA F3 春 从 天 上 来 Microblog SJEURB T , URL Hello, World. 

BYVoid 2012 





图 $-14 HIP va rg 


5.7.4 首页 








最 后 一 步 是 实现 首页 的 内 容 。 我 们 计划 在 首页 显示 所 有 用 户 发 表 的 微 博 , 按时 间 从 新 到 
旧 的 顺序 。 
在 routes/index.js 中 添加 下 面 代码 : 


app.get('/', function(req, res) ( 
Post.get (null, function(err, posts) { 
if (err) { 
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posts = rs 

】 

res.render('index', { 
title: ' 首 页 '， 


posts: posts, 





它 的 功能 是 读 取 所 有 用 户 的 微 博 ， 传 递 给 页 面 posts 属性 。 接 下 来 修改 首页 的 模板 


index.ejs: 


<% if (!user) { $»5 
«div class-"hero-unit" 
<h1> 欢 迎 来 到 Microblog«c/h1» 
<p>Microblog 是 一 个 基于 Node.js 的 微 博 系 统 。</D> 
<p> 
<a class="btn btn-primary btn-large" href="/login"> 登 录 </a> 
<a class="btn btn-large" href="/reg"> Pp; </a> 
</p> 
</div> 
<% } else ( %> 


<%- partial('say') $» 


oe 


<% } > 
<%- partial('posts') %> 


下 面 看 看 首页 的 效果 吧 ， 图 5-15 和 图 5-16 是 用 户 登 和 之 前 和 登入 以 后 看 到 的 首页 效果 。 





国 首 页 - microblog 
€ Q f | @ 127.0.0.1:3000 E > 


Microblog ”首页 


欢迎 来 到 Microblog 


Microblog 是 一 个 基于 Node.js 的 微 博 系统 。 


polyhedron 说 佛 振 说 byvoid 说 

Mon Apr 09 2012 20:26:43 GMT+0800 (CST) Mon Apr 09 2012 20:24:45 GMT+0800 (CST Mon Apr 09 2012 20:21:11 GMT+0800 (CST) 
Ko Sren zsih pok Krax Deng se,sjyix mjenh chrio RASANA, MIM! ARBRES. Bi 东周 破 早 梅 向 暖 一 枝 开 KERR 春 从 天 上 来 
bieng yon kiak te. kioix chjoh caux qreng creng 1E, HERRBUGOTSERA. tust ASERDE :-) 

nuanx zjyoh,zjyi kra sin qenh truk chjyn ne. luanh 

hrua ziemx jyuk me njin ngrenx,chiemx chaux zai 

nong muot mrax de. cuad qaih gho tung ghrang 

pyot cyuk,lyuk jang qim lix brak sra te. 

佛 振 说 byvoid 说 byvoid 说 

Mon Apr 09 2012 20:21:01 GMT+0800 (CST Mon Apr 09 2012 20:19:44 GMT+0800 (CST) Mon Apr 09 2012 20:18:58 GMT+0800 (CST) 
EANAN ETE BD Microblog 可 以 用 了 ,祝贺 ! Hello, World. 





图 5-15 ”登入 之 前 的 首页 
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首页 - Microblog 


c Q 人 | 127.0.0.1:3000 P A 
Microblog šm 
polyhedron 说 佛 振 说 byvoid 说 
Mon Apr 09 1 5:43 GMT 8 ( Mon Apr 09 4:45 GM 800 Mon Ar 02 3MT--08 
Ko Sren zsih pok Krax Deng se,sjyix mjenh chrio IAS, MAMI! ARUS. AX 东风 破 早 梅 向 暖 一 枝 开 2KSETRUA, Fd. 春 从 天 上 来 
bieng yon kiak te. kioix chjoh caux qreng creng 码 ， 排 解 BUG 好 贱 颗 。 有 没有 人 奖励 我 :-) 
uanx zjyoh,zjyi kra sin qenh truk chjyn ne. luanh 
hrua ziemx jyuk me njin ngrenx,chiemx chaux za 
nong muot mrax de. cuad qaih gho tung ghrang 
pyot cyuk,lyuk jang qim lix brak sra te. 
佛 振 说 byvoid 说 byvoid 说 
Me : )9 2012 20:21:01 GMT+0€ M Apr 09 2012 9:44 GM 800 ( ) Won Apr 0! ) 0:18:58 GM jE 
REMO A EANA Microblog 可 以 用 了 ， 袖 贺 ! Hello, World. 


BYVoid 2012 
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5.7.5 下 一 步 


到 此 为 止 ， 微 博 网 站 的 基本 功能 就 完成 了 。 这 个 网 站 仅仅 是 微 博 的 一 个 雏形 , 距离 真正 
的 微 博 还 有 很 大 的 距离 。 例 如 ,我 们 没有 对 注册 信息 进行 完整 的 验证 ， 如 用 户 名 的 规则 ， 密 
码 的 长 短 等 。 为 了 防止 恶意 注册 还 应 该 市 有 验证 合 和 邮件 认证 的 功能 ， 甚 至 还 应 该 文 持 
OAuth。 我 们 对 发 帖 没有 进行 任何 限制 ,尽管 注入 HTML 是 不 可 能 的 ,但 至 少 还 应 该 对 长 度 
有 限制 ,首页 和 用 户 页 面 的 显示 都 是 没有 数量 限制 的 , 当 微 博 很 多 以 后 这 个 页 面 可 能 会 很 长 ， 
应 该 实现 分 页 的 功能 。 作 为 社交 工具 ， 最 重要 的 用 户 关注 、 转 帖 、 评 论 、 圈 点 用 户 这 些 功 能 
都 没有 实现 。 

除了 功能 上 的 不 足 , 这 个 网 站 还 有 潜在 的 性 能 问题 ,例如 每 次 查询 数据 库 都 没有 限制 取 
得 的 数量 ,还 应 该 对 一 些 访 问 频 党 的 页 面 增 加 缓存 机 制 。 另 外 ,我 们 一 直 是 以 开发 模式 在 运 
行 着 这 个 网 站 ， 没 有 讨论 如 何 把 它 真 正 部 署 起 来 ， 我 们 会 在 下 一 章 详细 讨论 。 

如 果 你 对 这 个 用 Nodejs 实现 的 微 博 网 站 有 兴趣 ， 请 访问 https:/github.com/BYVoid/ 
microblog, 这 里 有 Microblog 示例 中 的 完整 代码 ， 而 且 在 其 基础 上 还 做 了 进一步 的 改进 ， 也 
欢迎 你 为 它 “ 添 砖 加 瓦 ”。 
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Express Guide: http://express;s.com/guide.html ; 
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在 本 书 的 最 后 一 草 ， 我 们 打算 讨论 几 个 独立 的 话题 ， 主 要 内 容 包括 : 
a 模块 加 载 机 制 ; 

口 寞 步 编程 模式 下 的 控制 流 ; 

口 Node.js 应 用 部 署 ; 

O Node.js 的 一 些 劣 执 ， 


6.1 模块 加 载 机 制 

Node js 的 模块 加 载 对 用 户 来 说 十 分 简单 ， 只 需 调 用 require 即 可 ,但 其 内 部 机 制 较为 
复杂 。 我 们 通过 这 一 节 简 要 介绍 一 下 Node.js 模块 加 载 的 一 些 细节 ， 帮 你 减少 开发 中 可 能 遇 
到 的 问题 。 





6.1.1 模块 的 类 型 


Node.js 的 模块 可 以 分 为 两 大 类 ， 一 类 是 核心 模块 ， 男 一 类 是 文件 模块 。 核 心 模块 就 是 
Node.js 标准 API 中 提供 的 模块 ， 如 fs. http. net. vm 等 ， 这 些 都 是 由 Node.js 官方 提供 
的 模块 ， 编 译 成 了 二 进 制 代码 。 我 们 可 以 直接 通过 require 获取 核心 模块 ， 例 如 
require('fs')。 核 心 模 块 拥有 最 高 的 加 载 优 先 级 ， 换 言 之 如 果 有 模块 与 其 命名 冲突 ， 
Node.js 总 是 会 加 载 核心 模块 。 

文件 模块 则 是 存储 为 单独 的 文件 (或 文件 夹 ) 的 模块 ,可 能 是 JavaScript 代码 、JSON 或 
编译 好 的 C/C++ 代码 。 文 件 模块 的 加 载 方法 相对 复杂 ， 但 十 分 灵活 ， 尤 其 是 和 npm 结合 使 
用 时 。 在 不 显 式 指定 文件 模块 扩展 名 的 时 候 ，Node.js 会 分 别 试图 加 上 .js、.json 和 .node 扩展 
4. js 是 JavaScript (Ñt, json 是 JSON 格式 的 文本 ，.node 是 编译 好 的 C/C++ 代码 。 

K 6-1 总 结 了 Node.js 模块 的 类 型 ， 从 上 到 下 加 载 优先 级 由 高 到 低 。 


表 6-1 Node.js 模块 的 类 别 和 加 载 顺 序 














核心 模块 内 建 
文件 模块 JavaScript Js 
JSON json 
C/C++ 扩展 .node 


6.1.2 ” 按 路 径 加 载 模块 


文件 模块 的 加 载 有 两 种 方式 ， 一 种 是 按 路 人 径 加 载 ， 一 种 是 查找 node modules 文件 夹 。 
如 果 require 参数 以 “/ ”开头 ,那么 就 以 绝对 路 径 的 方式 查找 模块 名 称 , 例 如 require 
('/home/byvoid/module') 将 会 按照 优先 级 依次 尝试 加 载 /home/byvoid/module.js 、 
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/home/byvoid/module.json 和 /home/byvoid/module.node。 

如 果 require 参数 以 “./” 或 “../ ”开头 ， 那么 则 以 相对 路 径 的 方式 来 查找 模块 ， 
这 种 方式 在 应 用 中 是 最 常见 的 。 例 如 前 面 的 例子 中 我 们 用 了 require('./hello') 来 加 载 
同一 文件 夹 下 的 hello.js。 








6.1.3 ”通过 查找 node modules 目录 加 载 模块 


如 果 require 参 数 不 以 “/”、“./” 或 “../” 开 头 ， 而 该 模块 又 不 是 核心 模块 ， 那 么 就 
要 通过 查找 node modules 加 载 模块 了 。 我 们 使 用 npm 获 取 的 包 通 篆 就 是 以 这 种 方式 加 载 的 。 

在 某 个 目录 下 执行 命令 npm install express， 你 会 发 现 出 现 了 一 个 叫做 node modules 
的 目录 ， 里 面 的 结构 大 概 如 图 6-1 所 示 。 


Y Lj node modules 
Y LJ express 
> 全 bin 
|| History.md 
. | index.js 
> Ø lib 
LICENSE 
| Makefile 
Y [d node modules 
Y LN connect 
| index.js 
> GJ ib 
^ LICENSE 
Y [L3 node modules 
Y LH formidable 
> [EJ benchmark 
> [LJ example 
index.js 
> (ug lib 
..| Makefile 
package.json 
Readme.md 
> (test 
TODO 
> (3 tool 


package.json 











6-1 node modules 目录 结构 


在 node modules 目录 的 外 面 一 层 ， 我 们 可 以 直接 使 用 require('express') 来 代替 
require('./node modules/express')。 这 是 Node.js 模 块 加 载 的 一 个 重要 特性 : 通过 得 
找 node modules 目录 来 加 载 模块 。 

当 require 遇 到 一 个 既 不 是 核心 模块 ， 又 不 是 以 路 径 形 式 表 示 的 模块 名 称 时 ， 会 试图 
在 当前 目录 下 的 node modules 目录 中 来 查找 是 不 是 有 这 样 一 个 模块 。 如 果 没 有 找到 ， 则 会 
在 当前 目录 的 上 一 层 中 的 node modules 目录 中 继续 查找 ， 反 复 执 行 这 一 过 程 ， 直 到 遇 到 根 
目录 为 止 。 举 个 例子 , 我 们 要 在 /home/byvoid/develop/foo.js 中 使 用 reauire('par.js') fm 
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令 ，Node.js 会 依次 查找 : 

口 /home/byvoid/develop/node modules/bar.js 

CQ /home/byvoid/node modules/bar.js 

CQ /home/node modules/bar.js 

CQ /node modules/bar.js 

为 什么 要 这 样 做 呢 ?” 因 为 通常 一 个 工程 内 会 有 一 些 子 日 录 , 当 子 目录 内 的 文件 需要 访问 
到 工程 共同 依赖 的 模块 时 ， 就 需要 癌 父 目录 上 湖 了 。 比 如 说 工程 的 目录 结构 如 下 : 








|- project 
|- app.js 
|- models 
|- views 
|- controllers 
- index controller.js 


- error controller.js 





|- node modules 





- express 


我 们 不 仅 要 在 project 目录 下 的 app.js 中 使 用 require('express')， 而且 可 能 要 在 
controllers 子 目 录 下 的 index controllerjs 中 也 使 用 require('express')， 这 时 就 需要 问 
父 日 录 上 湖 一 层 才 能 找到 node modules 中 的 express 了 。 











6.1.4 ”加 载 缓存 


我 们 在 前 面 提 到 过 ，Node.js 醒 块 不 会 被 重复 加 载 ， 这 是 因为 Node.js 通过 文件 名 绥 仓 所 
有 加 载 过 的 文件 模块 ， 所 以 以 后 再 访问 到 时 就 不 会 重新 加 载 了 。 注 意 ，Nodejs 是 根据 实际 文 
件 名 缓存 的 ， 而 不 是 requireO0 提供 的 参数 缓存 的 ， 也 就 是 说 即使 你 分 别 通过 
redquire('express') 和 require('./node modules/express') 加 载 两 次 ， 也 不 会 重 
复 加 载 ， 因 为 尽管 两 次 参数 不 同 ， 解析 到 的 文件 却 是 同一 个 。 


6.1.5 ”加 载 顺 序 


下 面 总 结 一 下 使 用 require(some module) 时 的 加 载 顺 序 。 
(1) 如 果 some_module 是 一 个 核心 模块 ， 下 接 加 载 ， 结 束 。 
(2) WR some moduleVA "/", ".J/" s "./" FK, IKIE some module, 结束。 
(3) 假设 当前 目录 为 current. dir， 按 路 径 加 载 current dir/node modules/some module. 
口 如 有 末 加 载 成 功 ， 结 束 。 


en 
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口 如 果 加 载 失败 ， 令 current dir 为 其 父 目 录 。 
口 重复 这 一 过 程 ， 直 到 遇 到 根 日 录 ， 抛 出 异常 ， 结 束 。 





6.2 Tem 


基于 异步 IO BUSECEXCBEUS Zr FERE BE AIEEE, Ida LH JL ER rij aes D 
碍 。 让 我 们 通过 下 面 的 例子 来 说 明 这 个 问题 。 





6.2.1 循环 的 陷阱 

Node.js 的 异步 机 制 由 事件 和 回调 函数 实现 ,一 开始 接触 可 能 会 感觉 违反 常规 , 但 习惯 
以 后 就 会 发 现 还 是 很 简单 的 。 然而 这 之 中 其 实 暗 藏 了 不 少 陷阱 ,一 个 很 容易 遇 到 的 问题 就 是 
循环 中 的 回调 也 数 ， 初 学 者 经 第 容易 陷入 这 个 圈套 。 让 我 们 从 一 个 例子 开始 说 明 这 个 问题 。 





//forloop.js 


var fs = require('fs'); 
var files = ['a.txt', 'b.txt', 'c.txt']; 
for (var i = 0; i < files.length; i++) { 
fs.readFile(files[i], 'utf-8', function(err, contents) { 
console.log(files[i] + ': ' + contents); 


I3 
} 


这 段 代 人 码 的 功能 很 下 观 ， 就 是 依次 读 取 文 件 a.txt、b.txt、c.txt， 并 输出 文件 名 和 内 容 。 
假设 这 三 个 文件 的 内 容 分 别 是 AAA、BBB 和 CCC， 那 么 我 们 期 望 的 输出 结果 就 是 : 





a.txt: AAA 
B'. txt: BBB 
CcC.txt: CCC 


可 是 我 们 运行 这 段 代 码 的 结 末 是 怎样 的 呢 ? 竟然 是 这 样 的 结 采 : 











undefined: AAA 
undefined: BBB 
undefined: CCC 


这 个 结果 说 明文 件 内 容 正 确 输出 了 ， 而 文件 名 却 不 对 ， 也 就 意味 着 ，contents 的 结 采 
是 正确 的 ,但 £iles[i] 的 值 是 undefined。 这 怎么 可 能 呢 ， 文 件 名 不 正确 却 能 读 取 文件 
WA? 既然 难以 直观 地 理解 , 我 们 就 把 files [i] 分 解 并 打印 出 来 看 看 , 在读 取 文件 的 回调 
函数 中 分 别 输出 files. i 和 files[i]。 
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//forloopi.js 


var fs = require('fs'); 

var files e ['a.txt', 'b.txt', 'c.txt']; 

for (var i = 0; i < files.length; i++) { 
fs.readFile(files[i], 'utf-8', function(err, contents) { 


console.log(files); 
console.log(i); 
console.log(files[il); 


jog 





} 


运行 修改 后 的 代码 ， 结 有 末 如 下 : 


| 
3 

undefined 

[ 'a.txt', 'b.txt', 'c.txt' ] 
3 

undefined 

[ "a.txt', 'b.txt', 'c.txt' ] 
3 

undefined 





看 到 这 里 是 不 是 有 点 局 发 了 呢 ? 三 次 输出 的 i 的 值 都 是 3， 超 出 了 files 数组 的 下 标 
范围 ， 因 此 files[i] 的 值 就 是 undefined 了 。 这 种 情况 通常 会 在 for 循环 结束 时 发 
Æ, MU for (var i = 0; i < files.lencth; i++)， 退 出 循环 时 i 的 值 就 是 
files.length 的 值 。 既然 i 的 值 是 35 那么 说 明了 事实 上 fs.readFile 的 回调 旺 数 中 
访问 到 的 宇 值 都 是 循环 退出 以 后 的 ， 因 此 不 能 分 辨 。 而 files[il 作为 fs.readFile 的 
第 一 个 参数 在 循环 中 就 传递 了 ， 所 以 文件 可 以 被 定位 到 ， 而 且 可 以 显示 出 文件 的 内 容 。 

现在 问题 就 明朗 了 : 原因 是 3 次 谈 取 文件 的 回调 函数 事实 上 是 同一 个 实例 ， 其 中 引用 到 
的 i 值 是 上 面 循环 执行 结束 后 的 值 ， 因 此 不 能 分 辨 。 如 何 解 决 这 个 问题 呢 ?” 我 们 可 以 利用 
JavaScript 困 数 式 编程 的 特性 ， 手 动 建立 一 个 财 包 : 




















//forloopclosure.js 


var fs = require('fs'); 
var files = ['a Lxt', 'b.txt', 'c.txt']; 
for (var i = 0; i < files.length; i++) ( 


(function(i) { 
fs.readFile(files[i], 'utf-8', function(err, contents) { 
console.log(files[i] + ': ' + contents); 


33 (2); 
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上 面 代码 在 for MAPES —T EU PRAG, PEDEPRIST UE SE i 作为 函数 的 参数 传 
递 并 调用 。 由 于 运行 时 闭 包 的 存在 ,该 匿名 函数 中 定义 的 变量 ( 包括 参数 表 ) 在 它 内 部 的 函 
数 ( fs .readFile BIER) 执行 完毕 之 前 都 不 会 释放 ， 因 此 我 们 在 其 中 访问 到 的 i 就 
分 别 是 不 同 的 团 包 实 例 ， 这 个 实例 是 在 循环 体 执行 的 过 程 中 创建 的 ,保留 了 不 同 的 值 。 

事实 上 以 上 这 种 写法 并 不 津 见 ， 因 为 它 降低 了 程序 的 可 读 性 ， 故 不 推荐 使 用 。 大 多 数 情 
况 下 我 们 可 以 用 数组 的 foreach 方法 解决 这 个 问题 : 























//callbackforeach.js 


var fs = require('fs'); 
var files = ['atxe',;, B.CxE", TC CXC l> 


files.forEach(function(filename) { 
fs.readFile(filename, 'utf-8', function(err, contents) { 
console.log(filename + ': ' + contents); 
»p3 
1) 9 


6.2.2 ”解决 控制 流 难 题 


除了 循环 的 陷阱 ，Node.js 异步 式 编程 还 有 一 个 显 铸 的 问题 ， 即 次 层 的 回调 函数 般 套 。 
在 这 种 情况 下 , 我 们 很 难 像 看 基本 控制 流 结构 一 样 一 眼看 清 回 调 冰 数 之 间 的 关系 ,因此 当 程 
序 规模 扩大 时 必须 采取 手段 降低 耦合 度 ， 以 实现 更 加 优美 、 可 读 的 代码 。 这 个 问题 本 身 没 有 
立竿见影 的 解决 方法 ， 只 能 通过 改变 设计 模式 ， 时 刻 注 意 降 低 逻 辑 之 间 的 耘 合 关 系 来 解决 。 

除 此 之 外 ， 还 有 许多 项 目 试图 解决 这 一 难题 。async 是 一 个 控制 流 解 耦 模块 ， 它 提供 了 
async.series, async.parallel, async.waterfall 等 图 数 ， 在 实现 复杂 的 逻辑 时 使 
用 这 些 了 本数 代 蔡 回调 函数 能 矢 可 以 让 程序 变 得 更 清晰 可 该 且 史 于 维护 , 但 你 必须 遵循 它 的 编 
程 风格 。 

streamlinejs 和 jscex 则 采用 了 更 高 级 的 手段 ， 它 的 思想 是 “ 变 同 步 为 异步 "， 实 现 了 一 个 
JavaScript 到 JavaScript 的 编译 硕 ， 使 用 户 可 以 用 同步 编程 的 模式 写 代 码 ， 编 译 后 执行 时 却 是 
异步 的 。 

eventproxy 的 思路 与 前 面 两 者 区 别 更 大 ， 它 实现 了 对 事件 发 射 带 的 次 度 封 竣 ， 采 用 一 种 
完全 基于 事件 松散 碳 合 的 方式 来 实现 控制 流 的 梳理 。 

无 论 是 以 上 哪 种 解决 手段 ， 都 不 是 “ 非 侵 入 性 的 "， 也 就 是 说 它 对 你 编程 模式 的 影响 是 
非常 大 的 , 你 几乎 不 可 能 无 代价 地 在 使 用 了 一 种 模式 很 久 以 后 从 容 地 换 成 男 一 种 模式 , 或 者 
百 接 狼 合 使 用 两 种 模式 。 而 且 它们 都 是 在 解决 了 深层 舱 套 的 回调 函数 可 恋 性 问题 的 同时 ,3 引 
人 了 其 他 复杂 的 语法 ,市 来 了 男 一 种 可 读 性 的 降低 。 所 以 ,是否 使 用 , 使 用 哪 种 方案 ， 在 决 
定之 前 是 需要 仔细 其 酌 人 研究 的 。 
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这 些 库 的 具体 使 用 方法 ， 力 至 实现 的 原理 以 及 更 深 一 步 的 讨论 已 经 超出 了 本 书 的 范围 ， 
欢迎 有 兴趣 的 读者 到 Node.js 中 文 社区 (http://club.cnodejs.org/ ) 交流 。 


6.3 Node.js 应 用 部 署 


在 第 5$ 草 我 们 已 经 使 用 Express 实 现 了 一 个 微 博 网 站 ， 在 开发 的 过 程 中 ,通过 nodqe app.js 











A 
大 还 有 几 个 重大 缺陷 。 

OQ 不 支持 故障 恢复 
不 知 你 是 否 在 调试 的 过 程 中 注意 ， 当 程序 有 错误 发 生 时 ,整个 进程 就 会 结束 ， 需 要 重 
新 在 终端 中 局 动 服 务 融 。 这 一 点 在 开发 中 无 可 厚 非 , 但 在 产品 环境 下 就 是 严重 的 问题 
了 ， 因 为 一 旦 用 户 访问 时 触发 了 程序 中 某 个 隐 含 的 bug， 整 个 服务 融 就 朋 溃 了 ， 将 无 
法 继续 为 所 有 用 户 提 供 服 务 。 在 部 署 Node.js 应 用 的 时 候 一 定 要 考虑 到 故障 恢复 ， 提 
高 系统 的 可 徘 性 。 

口 没有 日 志 
对 于 开发 者 来 说 , 日 志 , 尤其 是 错误 日 志 是 及 其 重要 的 , 经 党 查看 它 可 以 发 现 测试 时 
没有 注意 到 的 程序 错误 。 然而 这 个 服务 带 运 行 时 没有 产生 任何 日 志 , 包括 访问 日 志和 
错误 日 志 ， 所 以 有 必要 实现 它 的 日 志 功 能 。 

口 无 法 利用 多 核 提高 性 能 
由 于 Node.js 是 单线 程 的 ， 一 个 进程 只 能 利用 一 个 CPU 核心 。 当 请 求 大 量 到 来 时 ， 单 
线程 就 成 为 了 提高 咎 吐 量 的 瓶颈 。 随 着 多 核 力 至 众 核 时 代 的 到 来 ,只 能 利用 一 个 核心 
所 珊 来 的 浪费 是 十 分 严重 的 ， 我 们 需要 使 用 多 进程 来 提高 系统 的 性 能 。 

口 独占 端口 
假如 整个 服务 占 只 有 一 个 网 站 , 或 者 可 以 给 每 个 网 站 分 配 一 个 独立 的 IP 地 址 , 不 会 有 
闹 口 冲突 的 问题 。 而 很 多 时 候 为 了 充分 利用 服务 各 的 资源 , 我 们 会 在 同一 个 服务 侣 上 
建立 多 个 网 站 ,而 且 这 些 网 站 可 能 有 的 是 PHP， 有 的 是 Rails， 有 的 是 Node.js。 不 能 每 
个 进程 都 独占 80 端 口 ， 所 以 我 们 有 必要 通过 反 加 代理 来 实现 基于 域名 的 端口 共享 。 

口 需要 手动 局 动 
先前 每 次 局 动 服务 天 都 是 通过 在 命令 行 中 直接 键入 命令 来 实现 的 ， 但 在 产品 环境 中 ， 
特别 是 在 服务 亏 重 局 以 后 ,全 部 靠 手 动 司 动 是 不 现实 的 。 因 此 , 我 们 应 该 制作 一 个 上 自 
动 局 动 服 务 亏 的 脚本 ， 并 且 通 过 该 脚本 可 以 实现 停止 服务 需 等 功能 。 





















































6.3.1 日 志 功 能 
下 面 我 们 开始 在 第 $ 章 的 代码 的 基础 上 ， 介 绍 如 何 实现 服务 器 的 日 志 功 能 。Express 支 持 
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两 种 运行 模式 : 开发 模式 和 产品 模式 ， 前 者 的 目的 是 利于 调试 ， 后 者 则 是 利于 部 署 。 使 用 产 
品 模式 运行 服务 需 ee 单 ,只 需 设 置 NODE_ENV 环境 变量 ,通过 NODE_ENV=production 
node app .js 命 今 运 行 服务 厚 可 以 看 到 : 


Express server listening on port 3000 in production mode 


Be PRLR E H ERES H ze o UR] H zelo HH POS BS BREATH E 
求 , 包括 客户 端 耻 地 址 ， 访 问 时 间 ， 访 问 路 径 ， 服 务 器 响应 以 及 客户 端 代理 字符 串 。 而 错误 
日 志 则 记录 程序 发 生 错 误 时 的 信息 , 由 于 调试 中 需要 即时 查看 错误 信息 , 将 所 有 错误 直接 显 
示 到 终端 即 可 ， 而 在 产品 模式 中 ， 需 要 写 入 错误 日 志文 件 。 
Express 提供 了 一 个 访问 日 志 中 间 件 , 只 需 指定 stream 参数 为 一 个 输出 流 即 可 将 访问 日 
志 写 和 人 文件 。 打 开 app.js， 在 最 上 方 加 入 以 下 代码 : 





var fs = require('fs'); 
var accessLogfile = fs.createWriteStream('access.log', {flags: 'a')); 
var errorLogfile = fs.createWriteStream('error.log', (flags: 'a')); 


然后 在 app .configure 图 数 第 一 行 加 入 : 


app.use(express.logger(ístream: accessLogfile))); 


至 于 错误 日 志 ， 需 要 单独 实现 错误 啊 应 ， 修 改 如 下 : 


app.configure('production', function()( 





app.error(function (err, reg, res, next) { 
var meta = '[' + new Date() + '] ' + req.url + '\n'; 
errorLogfile.write(meta + err.stack + 'Mn'); 
next(); 
i) 
J 


这 段 代 码 的 功能 是 通过 app .error 注册 错误 啊 应 函数 ,在 其 中 将 错误 写 和 人 错误 日 志 流 。 
现在 重新 运行 服务 套 ， Se a 即 可 在 app.js 同一 目录 下 
的 access.log 文件 中 看 到 与 以 下 类 似 的 内 容 : 


127.0.0.1 - - [Thu, 5 Apr 2012 15:29:28 GMT] "GET / HTTP/1.1" 200 3389 "-" "Mozilla/5.0 
(Macintosh; Intel Mac OS X 10 7 3) AppleWebKit/535.19 (KHTML, like Gecko) 
Chrome/18.0.1025.162 Safari/535.19" 

127.0.0.1-- [Thu, 5 Apr 2012 15:29:28 GMT] "GET /stylesheets/bootstrap-responsive.css 
HTTP/1.1" 304 - "http://127.0.0.1:3000/" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10 7.3) 
AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.162 Safari/535.19" 

127.0.0.1 - - [Thu, 5 Apr 2012 15:29:28 GMT] "GET /javascripts/jquery.3js HTTP/1.1" 304 
e "http://127.0.0.1:3000/" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10 7 3) 
AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.162 Safari/535.19" 

127.0.0.1 - - [Thu, 5 Apr 2012 15:29:28 GMT] "GET /javascripts/bootstrap.js HTTP/1,.1" 
204 - "http://127.0.0.1:3000/" "Mozilla/5.0 (Macintosh; Intel Mac OS X .10-T 2) 
AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.162 Safari/535.19" 
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127.0.0.1 - - [Thu, 5 Apr 2012 15:29:28 GMT] "GET /stylesheets/bootstrap.css HTTP/1.1" 
304 - "http://127.0.0.1:3000/" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7 3) 
AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.162 Safari/535.19" 

127.0.0.1 - - [Thu, 5 Apr 2012 15:29:28 GMT] "GET /favicon.ico HTTP/1.1" 404 - "-" 
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10 7 3) AppleWebKit/535.19 (KHTML, like Gecko) 
Chrome/18.0.1025.162 Safari/535.19" 


为 了 产生 一 个 错误 ,我 们 修改 routes/index.js 中 “/” 的 啊 应 函数 ， 加 入 以 下 代码 : 
throw new Error('An error for test purposes.'); 


再 次 访问 http://127.0.0.1:3000/, RI EUE SI] errorlog 输出 了 完整 的 错误 内 容 ， 如 下 所 示 : 


[Thu Apr 5 2012 23:33:21 GMT+0800 (CST)] / 
Error: An error for test purposes. 
at Object.«anonymous» (/byvoid/microblog/routes/index.js:7:11) 
at nextMiddleware (/byvoid/microblog/node modules/express/node modules/connect/ 
lib/middleware/router.js:175:25) 
at param (/byvoid/microblog/node modules/express/node modules/connect/lib/ 
middleware/router.js:183:160) 
at pass (/byvoid/microblog/node modules/express/node modules/connect/lib/ 
middleware/router.js:191:10) 
at Object.router [as handle] (/byvoid/microblog/node modules/express/ 
node modules/connect/lib/middleware/router.js:197:60) 
at next (/byvoid/microblog/node modules/express/node modules/connect/lib/ 
http.js:203:15) 
at /byvoid/microblog/node modules/express/node modules/connect/lib/middleware/ 





























Session.js:323:9 
at /byvoid/microblog/node modules/express/node modules/connect/lib/middleware/ 





Session.js:342:9 
at /byvoid/microblog/node modules/connect-mongo/lib/connect-mongo.js:151:15 
at /byvoid/microblog/node modules/connect-mongo/node modules/mongodb/lib/ 

mongodb/collection.js:885:34 


这 样 ， 一 个 简单 有 效 的 日 志 功 能 就 这 样 实现 了 。 














6.3.2 使 用 cluster 模 块 


从 0.6 版 本 开始 ，Node.js 提供 了 一 个 核心 模块 cluster。cluster 的 功能 是 生成 与 当 
前 进程 相同 的 子 进 程 ， 并 且 人 允许 父 进程 和 子 进程 之 间 共 享 端口 。Node.js 的 男 一 个 核心 模块 
child process 也 提供 了 相似 的 进程 生成 功能 , 但 最 大 的 区 别 在 于 cluster 允许 跨 进 程 端 
口 复 用 ， 给 我 们 的 网 络 服务 硕 开 发 市 来 了 很 大 的 方便 。 

为 了 在 外 部 模块 调用 app.js, 首先 需要 禁止 服务 需 上 自动 启 动 。 修 改 app.js, fEapp. listen 
(3000); 前 后 加 上 判断 语句 : 

















if (!module.parent) { 
app.listen(3000); 
console.log("Express server listening on port $d in $s mode", app.address().port, 


app.settings.env); 
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这 个 语句 的 功能 是 判断 当前 模块 是 不 是 由 其 他 模块 调用 的 ,如果 不 是 , 说 明 它 是 直接 局 
动 的 ， 此 时 启动 调试 服务 右 ; 如 果 是 ， 则 不 目 动 启动 服务 磊 。 经 过 这 样 的 修改 ,以 后 直接 调 
用 node app.js 服 务 右 会 百 接 运 行 ， 但 在 其 他 模块 中 调用 require('./app') 则 不 会 目 动 
启动 ， 需 要 再 显 式 地 调用 1isten() AŽ 

接 下 来 就 让 我 们 通过 cluster 调用 app.js。 创 建 clusterjs， 内 容 如 下 所 示 : 











var cluster = require('cluster'); 


var os = require('os'); 


// 获取 CPU 的 数量 
var numCPUs = os.cpus().length; 


var workers = (); 
if (cluster.isMaster) { 
//| 主 进程 分 支 
cluster.on('death', function (worker) ( 
// 当 一 个 工作 进程 结束 时 ， 重 启 工作 进程 
delete workers([worker.pid]; 
worker - cluster.fork(); 
workers[worker.pid] - worker; 

J)? 

// 初始 开启 与 CPU 数量 相同 的 工作 进程 
for (var i = 0; i < numCPUs; i++) ( 
var worker - cluster.fork(); 

workers[worker.pid] - worker; 

j 
j else ( 

// 工作 进程 分 支 ， 局 动 服务 器 
var app = require('./app'); 
app.listen(3000); 
j 
// 当主 进程 被 终止 时 ， 关 闭 所 有 工作 进程 
process.on('SIGTERM', function () { 





for (var pid in workers) ( 
process.kill(pid); 
j 
process.exit(0); 


12-3 


cluster.js 的 功能 是 创建 与 CPU TURRIS A ze XERE. DM TA TI RIZ TRXCPU 的 
资源 。 主 进程 生成 奉 干 个 工作 进程 ,并 监听 工作 进程 结束 事件 ， 当 工作 进程 结束 时 ， 重 新 局 
动 一 个 工作 进程 。 分 文 进 程 产生 时 会 目 顶 回 下 重新 执行 当前 程序 , 并 通过 分 支 判 断 进 入 工作 
进程 分 文 , 在 其 中 该 取 模 块 并 局 动 服务 硕 。 通 过 clustetr 局 动 的 工作 进程 可 以 直接 实现 端口 
复 用 , 因此 所 有 工作 进程 只 需 监听 同一 端口 。 当 主 进 程 终 止 时 , 还 要 主动 关闭 所 有 工作 进程 。 
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在 终端 中 执行 node cluster.js 命令， 可 以 看 到 进程 列表 中 启动 了 多 个 node 进 程 (8 
核 CPU ): 














12408 7? 00:01:28 node 
12411 ? 00:01:27 node 
12412 ? 00:01:28 node 
12414 ? 00:01:31 node 
12416 7? 00:01:34 node 
12418 ? 00:01:44 node 
12420 ? 00:01:38 node 
12422 7 00:01:34 node 
12424 ? 00:02:14 node 





终止 工作 进程 ， 新 的 工作 进程 会 立即 局 动 ， 终 止 主 进 程 ， 所 有 工作 进程 也 会 同时 结 
这 样 ， 一 个 既 能 利用 多 核资 源 ， 又 有 实现 故障 恢复 功能 的 服务 大 了 央 证 生 了 。 


6.3.3 ”局 动 脚本 


接 下 来 ， 我 们 还 需要 一 个 局 动 脚本 来 简化 维护 工作 。 如 采 你 维护 过 Linux 服务 器 ， 会 对 
/etc/init.d/ 下 面 的 脚本 有 印象 。 例 如 使 用 /etc/init.d/nginx start f/etc/init.d/ 
nginx stop 可 以 启动 和 关闭 Nginx 服务 如。 我 们 通过 bash 脚本 也 来 实现 一 个 类 似 的 功能 ， 
创建 microblog 并 使 用 chmod «x microblog 赋予 其 执行 权限 ， 脚 本 内 容 为 : 


t! /bin/sh 





NODE ENV-production 
DAEMON-"node cluster.js" 
NAME-zMicroblog 
DESCzMicroblog 
PIDEILEsS"'microblog.pid^ 





case "S1" in 
start) 
echo "Starting SDESC: " 
nohup $DAEMON > /dev/mnull & 
echo $! » SPIDFILE 
echo "SNAME." 





stop) 
echo "Stopping S$DESC: " 
pid='cat SPIDFILE' 
kill $pid 
rm SPIDFILE 
echo "SNAME." 
esac 


exit 0 
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它 的 功能 是 通过 nohup 启动 服务 器 ， 使 进程 不 会 因为 退出 终端 而 关闭 ， 同 时 将 主 进程 
的 pid 写 人 microblog.pid 文件 。 当 调用 结束 命令 时 ， 从 microblog.pid pia 的 值 ， 终 止 主 
进程 以 关闭 服务 做 。 

运行 ./microblog start, £i. 


Starting Microblog: 
Microblog. 


TEYA H 3€ FÆR f microblog.pid X £F, EA RE n] LUI S RC ZR SI. KAIRA zs] 
只 需 执行 . /microblog stop， 即 可 结束 所 有 工作 进程 。 

有 了 这 个 局 动 脚 本 ， 我 们 就 可 以 实现 服务 大 的 开机 上 自动 局 动 了 了， 根据 不 同 的 操作 系统 ， 
将 其 加 入 启动 运行 项 即 可 ， 唯 一 需要 修改 的 地 方 是 DAEMON 和 PIDFILE 应 该 写成 绝对 路 径 ， 
以 便 在 不 同 的 目录 下 运行 。 

















4 这 上 段 脚本 只 支持 POSIX 操 作 系 统 ， 如 Linux, MacOS &, 4& Windows 
警告 下 不 可 用 。 


6.3.4 ”共享 80 端口 


到 目前 为 止 ， 网 站 都 是 运行 在 3000 端 口 下 的 ， 也 就 是 说 用 户 必须 在 网 址 中 加 入 :3000 才 
能 访问 网 站 。 默 认 的 HITTP 端口 是 80， 因 此 必须 监听 80 端 口才 能 使 网 址 更 加 简洁 。 如 果 整 个 
服务 器 只 有 一 个 网 站 ， 那 么 只 需 让 app.js 监听 80 端口 即 可 。 但 很 多 时 候 一 个 服务 右上 运行 
着 不 止 一 个 网 站 ， 尤 其 是 还 有 用 其 他 语言 ( 如 PHP ) 写成 的 网 站 ， 这 该 怎么 办 呢 ? 此 时 虚拟 
主机 可 以 粉墨登场 了 。 

虚拟 主机 ， 就 是 让 多 个 网 站 共享 使 用 同一 服务 需 同 一 下 地 址 ， 通 过 域名 的 不 同 来 划分 请 
求 。 主 流 的 HTTP 服务 需 都 提供 了 虚拟 主机 文 持 ， 如 Nginx、Apache、IIS 等 。 我 们 以 Nginx 为 
例 ， 介 绍 如 何 通 过 反 回 代理 实现 Node.js 虚拟 主机 。 

在 Nginx 中 设置 反 回 代理 和 虚拟 主机 非常 简单 ， 下 面 是 配置 文件 的 一 个 示例 : 

server { 


listen 805 


Server name mysite.com; 











location / ( 
Dproxv pass http://localhost:3000; 
】 

】 


这 个 配置 文件 的 功能 是 监听 访问 mysite.com 80 端口 的 请 求 ， 并 将 所 有 的 请 求 转发 给 
http:/localhost:3000 ， 即 我 们 的 Node.js 服务 硕 。 现 在 访问 http:/mysite.com/， 就 相当 于 服务 天 
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访问 http://localhost:3000 了。 

在 添加 了 虚拟 主机 以 后 ， 还 可 以 在 Nginx 配 置 文件 中 添加 访问 项 态 文 件 的 规则 〈 有 具体 请 
参考 Nginx 文 档 ), 删 去 app.js 中 的 app.use(express.static(_ dirname + '/public'));。 
这 样 可 以 直接 让 Nginx 来 处 理 静 态 文件 ， 减 少 反 回 代 理 以 及 Node:js 的 开销 。 


6.4 Node.js 不 是 银 弹 


在 本 书 正文 的 最 后 一 帮 ， 我 们 打算 讨论 一 人 Node,js 不 适合 做 什么 ， 涉 及 它 的 不 足 之 处 
II — EE BER o 

EADE, mpg UR ACT AEW, AREENA KATA 
不 同 之 处 , 但 每 到 月 圆 之 夜 ， MAREEN o KERIA, PESARE E], IF 
台 玖 击 普通 的 人 类。 狼人 给 人 类 市 来 了 巨大 的 恐惧 ， 因 为 他 们 是 无 法 被 一 般 的 手段 杀 死 的 ， 
只 有 用 赐 福 过 的 银 弹 〈Silver Bullet) 才能 杀 死 狼人 。“ 银 弹 ” 因 此 成 为 了 “任何 能 够 市 来 极 
大 效 末 的 直接 解决 方案 ”的 代名词 。 

Fred Brooks "在 1987 年 发 表 了 一 篇 关于 软件 工程 的 经 典 文章 一 一 “No Silver Bullet" ( 没 
有 和 银 弹 )。 所 谓 的 “没有 银 弹 ” 指 的 就 是 没有 任何 一 项 技术 或 方法 可 使 软件 工程 的 生产 力 能 
像 摩 尔 定律 一 样 在 十 年 内 提高 超过 十 倍 ,不 仅 当 时 没有 ,现在 也 没有 , 今后 也 不 会 有 。 这 篇 
文 草 收录 在 《人 月 神话 》( The Mythical Man-Month ) 一 书 中 ,被 人 誉 为 软件 工程 领域 的 基本 定 
律 之 一 。 

Node.js 也 不 例外 ， 它 不 是 什么 能 够 大 幅度 提高 软件 开发 效率 和 质量 的 灵丹妙药 。 无 论 
使 用 什么 语言 、 工 具 , 所 能 改变 的 仅仅 是 开发 的 舒适 程度 和 方便 程度 ， 而 最 终 软件 的 好 坏 所 
能 改变 的 范围 相当 有 限 。 任何 试图 以 限制 程序 员 犯 错 来 提高 软件 质量 的 方式 最 终 痢 已 经 以 失 
败 告终 。 真 正 优秀 的 软件 是 徘 优秀 的 程序 员 开 发 出 来 的 ,优秀 的 语言 、 平 台 、 工 具 只 有 在 优 
秀 的 程序 员 的 手中 才能 显现 出 它 的 威力 。 


Node.js 不 适合 做 什么 


Nodejs 是 一 个 优秀 的 平台 ,吸引 大 量 开发 者 关注 。 它 有 许多 传统 染 构 不 具备 的 优点 ， 
以 至 于 我 们 情不自禁 地 愿意 用 它 来 做 开发 。Node.js 和 任何 东西 一 样 ， 都 有 它 擅长 的 和 不 擅 
长 的 事情 ， 如 于 你 非 要 用 它 来 做 它 不 擅长 的 事情 , 那么 你 将 会 陷入 僵局 之 中 。 尽 管 你 可 以 以 
袁 欢 、 它 很 新 漳 、 性 能 高 为 全 口 ， 却 不 得 不 写 出 难看 的 代码 。 

和 大 多 数 新 技术 的 本 质 一 样 ，Node.js 也 只 是 旧 瓶 威 新 酒 。 大 多 数 人 事实 上 并 不 知道 为 
什么 使 用 Node.js， 只 是 因为 你 了 解 它 ， 所 以 使 用 它 ， 进 而 觉得 它 好 ， 觉得 它 是 最 合适 的 。 这 
是 一 个 必须 跳出 的 误区 ， 否 则 你 就 像 是 得 了 强迫 症 ， 不管 三 七 二 十 一 ， 遇 到 什么 问题 都 用 

























































































D IBM 大 型 计算 机 之 父 ， 曾 经 开发 过 OS/360 等 大 型 计算 机 的 操作 系统 。 
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Node.js 解决 。 

所 以 现在 就 让 我 们 来 谈 谈 Node.js 不 适合 做 的 事情 吧 。 

1. 计算 密集 型 的 程序 

在 Node.js 0.8 版 本 之 前 ，Node.js 不 文 持 多 线程 。 当 然 ， 这 是 一 种 设计 哲学 问题 ， 因 为 
Node.js 的 开发 者 和 支持 者 坚信 单线 程 和 事件 驱动 的 异步 式 编程 比 传 统 的 多 线程 编程 运行 效 
率 更 高 。 但 事实 上 多 线程 可 以 达到 同样 的 否 吐 量 , 尽管 可 能 开销 不 小 , 但 不 必 为 多 核 环 境 进 
行 特 殊 的 配置 。 相 比 之 下 ，Node.js 由 于 其 单线 程 性 的 特性 ， 必 须 通 过 多 进程 的 方法 才能 
分 利用 多 核资 源 。 

理想 情况 下 , Node.js 单 线程 在 执行 的 过 程 中 会 将 一 个 CPU 核心 完全 占 满 , 所 有 的 请 求 必 
须 等 竺 当前 请 求 处 理 完毕 以 后 进入 事件 循环 才能 啊 应 。 如 采 一 个 应 用 是 计算 密集 型 的 , 那么 
除非 你 手动 将 它 拆散 ,否则 请 求 啊 应 延迟 将 会 相当 大 。 例 如 ， 某 个 事件 的 回调 旺 数 中 要 进行 
复杂 的 计算 ， 占 用 CPU 200 训 秒 ， 那 么 事件 循环 中 所 有 的 请 求 都 要 等 待 200 训 秒 。 为 了 提高 
吧 应 速度 ,你 唯一 的 办 法 就 是 把 这 个 计算 密集 的 部 分 拆 成 奋 干 个 逻辑 , 这 给 编程 带 来 了 额外 
的 复杂 性 。 即使 这 样 , 系统 的 总 吞吐 量 和 总 啊 应 延迟 也 不 会 降低 , 只 是 调度 稍微 公平 了 一 些 。 

不 过 好 在 真正 的 Web 服务 器 中 , 很 少 会 有 计算 密集 的 部 分 ， 如 果真 的 有 ， 那么 它 不 应 该 
外 Q 实 现 为 即时 的 响应 。 正 确 的 方式 是 给 用 户 一 个 提示 , 说 服务 右 正 在 处 理 中 ,完成 后 会 通知 
用 户 ， 然 后 交 给 服务 融 的 其 他 进程 甚至 其 他 专职 的 服务 融 来 做 这 件 事 。 

2. 单 用 亡 多 任务 型 应 用 

前 面 我 们 讨论 的 通常 都 是 服务 右 问 编程 ,其 中 一 个 假设 就 是 用 户 数量 很 多 。 但 如 果 面 对 
的 是 单 用 户 ， 辟 如 本 地 的 命令 行 工具 或 者 图 形 界面 ， 那 么 所 谓 的 大 量 并 发 请 求 就 不 存在 了 。 
于 是 另 一 个 轴 怖 的 问题 出 现 了 ,尽管 是 单 用 户 ， 却 不 一 定 是 单 任务 。 例 如 给 用 户 提 供 界 面 的 
同时 后 台 在 进行 某 个 计算 , 为 了 让 用 户 界 面 不 出 现 阻塞 状态 , 你 不 得 不 开局 多 线程 或 多 进程 。 
而 Node.js 线程 或 进程 之 间 的 通信 到 目前 为 止 还 很 不 便 ， 因 为 它 根 本 没有 锁 ， 因 而 号 称 不 会 
和 死 锁 。Node.js 的 多 进程 往往 是 在 执行 同一 任务 ， 通 过 多 进程 利用 多 处 理 需 的 资源 ， 但 遇 到 
多 进程 相互 协作 时 ， 就 显得 捉襟见肘 了 。 

3. 逻辑 十 分 复杂 的 事务 

Node.js 的 控制 流 不 是 线性 的 ， 它 被 一 个 个 事件 拆散 ,但 人 的 思维 却 是 线性 的 ， 当 你 试 
图 转换 思维 来 迎合 语言 或 编译 右 时 ,就 不 得 不 作出 牺牲 。 举 例 来 说 ,你 要 实现 一 个 这 样 的 逻 
辑 : 从 银行 取 钱 ， 拿 钱 去 购买 某 个 虚拟 商品 ， 买 完 以 后 加 入 库存 数据 库 ， 这 中 间 的 任何 一 步 
都 可 能 会 涉及 数 十 次 的 1/O 操 作 ， 而 且 任 何 一 次 操作 失败 以 后 都 要 进行 回 深 操 作 。 这 个 过 程 
是 线性 的 , 已 经 很 复杂 了 ， 如 采 要 拆 分 为 非 线性 的 逻辑 , 那么 其 复杂 程度 很 可 能 就 达到 无 法 
维护 的 地 步 了 。 

Node.js 更 善于 处 理 那些 逻辑 简单 但 访问 频繁 的 任务 ， 而 不 适合 完成 逻辑 十 分 复杂 的 
工作 
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4. Unicode 与 国际 化 

Node.js 不 文 持 完整 的 Unicode ,很 多 字符 无 法 用 string 表示 。 公 平地 说 这 不 是 Node.js 的 
缺陷 ， 而 是 JavaScript 标准 的 问题 。 目 前 JavaScript 支持 的 字符 集 还 是 双 字 节 的 UCS2， 即 用 
两 个 字 节 来 表示 一 个 Unicode FIF, 这样 能 表示 的 字符 数量 是 65536。 显然, 仅仅 是 汉字 就 不 
止 这 个 数目 ,很 多 生 个 汉字 ,以 及 一 些 较为 罕见 语言 的 文字 都 无 法 表示 。 这 其 实 是 一 个 历史 
遗留 问题 , 像 2000 年 问题 ( 俗称 千年 虫 ) 一 样 , 都 起 源 于 当时 人 们 的 主观 判断 ,最 早 的 Unicode 
设计 者 认为 65536 个 字符 足以 早 括 全 址 界 所 有 的 文字 了 ,因此 那个 时 候 盲 目 兼 容 Unicode 的 系 
统 或 平台 ( 如 Windows、Java 和 JavaScript ) 在 后 来 都 遇 到 了 问题 。 

Unicode 随后 意识 到 2 个 字 节 是 不 够 的 ， 因 此 推出 了 UCS4， 即 用 4 个 字 节 来 表示 一 个 
Unicode 字符 。 很 多 原先 用 定 长 编码 的 UCS2 的 系统 都 升级 为 了 变 长 编码 的 UTF-16， 因 为 只 
AEN P3EZEUCS2. UTF-16 对 UCS2 以 内 的 字符 采用 是 长 的 双 字 和 编码 ,而 对 它 以 外 的 部 分 
使 用 多 字 节 的 变 长 编码 。 这 种 方式 的 好 处 是 在 绝 大 多 数 情 况 下 它 都 是 定 长 的 编码 ， 有 利于 提 
高 运算 效率 ， 而 且 兼 容 了 UCS2， 但 缺点 是 它 本 质 还 是 变 长 编码 ， 程 序 中 处 理 多 少 有 些 不 便 。 

许多 号 称 支 持 UTF-16 的 平台 仍然 只 支持 它 的 子 集 UCS2， 而 不 支持 它 的 变 长 编码 部 分 。 
相 比 之 下 ，UTF-8 完全 是 变 长 编码 , 有 利于 传输 ， 而 UTF-32 或 UCS4 则 是 4 字 节 的 定 长 编码 ， 
有 利于 计算 。 

当下 的 JavaScript 内 部 支持 的 仍 是 定 长 的 UCS2 而 不 是 变 长 的 UTF-16， 因 此 对 于 处 理 
UCS4 的 字符 它 无 能 为 力 。 所 有 的 JavaScript 引擎 都 被 迫 保留 了 这 个 缺陷 ， 包 括 V8 ÆN, 
此 你 无 法 使 用 Node.js 人 处理 罕 见 的 字符 。 想 用 Node.js 实现 一 个 多 语言 的 字典 工具 ?还 是 算 了 
吧 ， 除 非 你 放弃 使 用 string 数据 类 型 ， 把 所 有 的 字符 当 作 二 进 制 的 Buffer 数据 来 处 理 。 
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长 久 以 来 ，JavaScript 总 是 被 广大 的 专业 开发 者 轻视 ,不 少 人 以 为 JavaScript 是 像 
VBScript 一 样 的 雕 虫 小 技 , 或 者 说 是 给 非 专 业 的 网 页 设计 者 用 的 简易 工具 。 而 早期 的 因特网 
上 也 恰恰 流传 者 大 量 低 质 量 的 JavaScript 代码 ， 很 多 都 是 可 视 化 网 页 设计 工具 生成 的 ， 复杂 
而 混乱 ， 更 加 深 了 人 们 对 它 的 不 良 印 象 。 在 当时 ，JavaScript 的 一 个 主要 作用 是 在 网 页 上 显 
示 出 花哨 的 效果 ， 壁 如 弹出 令 人 厌烦 的 广告 欠 口 。 

早期 的 JavaScript 运行 效率 人 低下、 浏览 各 羔 容 性 问题 严重 。 就 连 JavaScript 之 父 Brendan 
Eich 都 觉得 它 很 兰 ， 从 来 没有 想 过 它 能 够 发 展 成 今天 的 样子 。 后 来 随 着 以 Gmail 为 代表 的 
Web 2.0 应 用 的 兴起 ， 人 们 开始 重新 认识 JavaScripts 

JavaScript 经 历 了 一 个 十 分 纠结 的 发 展 过 程 ， 因 为 ECMAScript 新 标准 总 是 在 提出 后 厂 
干 年 才 会 被 浏览 磊 开 发 商 陆 续 实 现 ， 所 以 开发 者 不 得 不 人 奶 痛 割爱 放弃 许多 JavaScript 优美 的 
新 特性 ， 以 保持 浏览 器 之 间 的 兼容 性 。 值 得 庆幸 的 是 ， 这 些 问题 在 Node js 中 已 不 复 存在 ， 
我 们 可 以 放心 地 至 受 JavaScript 的 全 部 特性 给 我 们 市 来 的 便利 卫 。 这 些 特性 大 多 已 经 是 现代 
编程 语言 共有 的 理念 ， 例 如 面 癌 对 象 、 也 数 式 编程 思想 、lambda 演算 、 闭 包 、 动 态 绑 定 等 。 

我 假设 你 了 解 JavaScript 的 基本 语法 ， 并 且 对 面 品 对 象 的 语言 有 一 定 的 理解 ， 如 果 你 还 
知道 函数 式 编程 (functional programming )， 那 么 你 将 可 以 很 容易 地 理解 闭 包 。 本 附录 通过 
大 量 的 示例 帮 你 了 解 JavaScript 众多 特性 ， 理 解 JavaScript 背后 的 机 制 。 我 们 以 作用 域 、 闭 
包 和 对 象 为 线索 ， 介 绍 JavaScript 编程 中 常用 到 的 特性 和 技巧 。 


A.1 作用 域 


作用 域 ( scope ) 是 结构 化 编程 语言 中 的 重要 概念 ， 它 决定 了 变量 的 可 见 范围 和 生命 周 
期 ,正确 使 用 作用 域 可 以 使 代码 更 清晰 、 易 懂 。 作 用 域 可 以 减少 命名 冲突 ,而 且 是 垃圾 回收 
的 基本 单元 。 和 C、C++、Java Sede Doi pH], JavaScript 的 作用 域 不 是 以 花 插 号 包围 的 块 
级 作用 域 (block scope )， 这 个 特性 经 党 被 大 多 数 人 忽视 ， 因 而 导致 更 名 其 妙 的 错误 。 例 如 
FARE, 在 大 多 数 类 C 的 语言 中 会 出 现 变 量 未 定义 的 错误 ,而 在 JavaScript 中 却 完全 合法 : 


















































if (true) { 
var somevar - 'value'; 
} 


console.log(somevar); // 输出 value 


REAN JavaScript WFH REEE RARE, if for IJ BBJEdS mh 
立 的 作用 域 。 





A.1.1 函数 作用 域 
不 同 于 大 多 数 类 C 的 语言 ， 由 一 对 花 括号 封闭 的 代码 块 就 是 一 个 作用 域 ，JavaScript 的 
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作用 域 是 通过 子 数 来 定义 的 , 在 一 个 也 数 中 定义 的 变量 只 对 这 个 函数 内 部 可 见 , 我 们 称 为 函 
数 作 用 域 。 在 晒 数 中 引用 一 个 变量 时 ，JavaScript 会 完 搜索 当前 函数 作用 域 , 或 者 称 为 “局 
部 作用 域 ”， 如 果 没 有 找到 则 搜索 其 上 层 作 用 域 ， 一 直到 全 局 作用 域 。 我 们 看 一 个 简单 的 
例子 : 











var vl = 'v1'; 


var f1 = function() (| 
console.log(v1); // 输出 v1 


LLI? 


var f2 = function() { 
var vl = 'local'; 
console.log(v1); // 输出 local 


£2(); 


以 上 示例 十 分 明了 ，JavaScript HU PRZIGE X Xen] IREK, SEM EE PEHBA, E 
搜索 顺序 是 从 内 到 外 。 下 面 这 个 例子 可 能 就 有 些 令 人 困惑 : 


var scope = 'global'; 


var f = function() { 
console.log(scope); // fs undefined 
var scope - 'f'; 
j 
E33 
上 上面 代 码 可 能 和 你 预想 的 不 一 样 , 没有 输出 global, 而 是 undefined, 这 是 为 什么 呢 ? 
这 是 JavaScript 的 一 个 特性 ， 按 照 作 用 域 搜索 顺序 ， 在 console.log KOJE] scope 75 
量 时 ，JavaScript Ao S 的 作用 域 ， 恰巧 在 £ 作用 域 里 面 搜索 到 scope 变量 ， 
所 以 上 层 作 用 域 中 定义 的 scope 就 被 屏蔽 了 ,但 执行 到 console.log 语句 时 ，scope 还 
没 被 定义 ， 或 者 说 初始 化 ， 所 以 得 到 的 就 是 undefined 什 了。 
我 们 还 可 以 从 为 一 个 角度 来 理解 : 对 于 开发 者 来 说 , 在 访问 未 定义 的 变量 或 定义 了 但 没 
有 初始 化 的 变量 时 ， 获 得 的 值 都 是 undefined。 于 是 我 们 可 以 认为 ,无 论 在 函数 内 什么 地 
方 定义 的 变量 ， 在 一 进入 函数 时 就 被 定义 了 ,但 耳 到 var 所 在 的 那 一 行 它 才 被 初始 化 ， 所 
以 在 这 之 前 引用 到 的 都 是 undefined 值 。( 事实 上 ，JavaScript 的 内 部 实现 并 不 是 这 样 ， 未 
定义 变量 和 值 为 undefined 的 变量 还 是 有 区 别 的 。) 
函数 作用 域 的 能 套 
接 下 来 看 一 个 稍微 复杂 的 例子 : 
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var f = function() { 
var scope = 'f0'; 
(function() (| 
var scope = 'fl1'; 
(function() (| 
console.log(scope); // 输出 fl 
}) (); 
}) (); 
上 


上 面 是 一 个 函数 作用 域 鹏 套 的 例子 ， 我 们 在 最 内 层 也 数 引 用 了 scope 变量 ,通过 作用 
域 搜 索 ， 找 到 了 其 父 作 用 域 中 定义 的 scope 变量 。 

有 一 点 需要 注意 : 函数 作用 域 的 航 侠 关系 是 定义 时 决定 的 ， 而 不 是 调用 时 决定 的 ， 也 就 
是 说 ，JavaScript 的 作用 域 是 静态 作用 域 ， 叉 叫 词法 作用 域 ， 这 是 因为 作用 域 的 散人 套 关 系 可 
以 在 场 法 分 析 时 确定 ， 而 不 必 等 到 运行 时 确定 。 下 面 的 例子 说 明了 这 一 切 : 

















var scope = 'top'; 


var f1 = function() ( 
console.log(scope); 

H4 

£10; // 输出 top 


var f2 = function() { 
var scope - 'f2'; 
f1(); 


Hi 

t2() A AU top 

这 个 例子 中 ,通过 f2 调用 的 fl 在 查找 scope 定义 时 ， 找 到 的 是 父 作 用 域 中 定义 
的 scope 变量 ， 而 不 是 £2 中 定义 的 scope 变量 。 这 说 明了 作用 域 的 般 套 关系 不 是 在 调用 
时 确定 的 ， 而 是 在 定义 时 确定 的 。 


A.1.2 全 局 作用 域 


在 JavaScript 中 有 一 种 特殊 的 对 象 称 为 全 局 对 系 。 这 个 对 和 象 在 Node.js 对 应 的 是 global 
对 象 , 在 浏览 硕 中 对 应 的 是 window I Z -o 由 于 全 局 对 象 的 所 有 属性 在 任何 地 方 都 是 可 见 的 ， 
所 以 这 个 对 象 又 称 为 全 局 作用 域 。 全 局 作用 域 中 的 变量 不 论 在 什么 函数 中 都 可 以 被 直接 引 
用 ， 而 不 必 通 过 全 局 对 象 。 

满足 以 下 条 件 的 变量 属于 全 局 作用 域 : 

a 在 最 外 层 定 义 的 变量 ; 

口 全 局 对 象 的 属性 ; 
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a 任何 地 方 隐 式 定义 的 变量 ( 未 定义 下 接 赋 值 的 变量 )。 

需要 格外 注意 的 是 第 三 点 , 在 任何 地 方 隐 式 定义 的 变量 都 会 定义 在 全 局 作用 域 中 ， 即 不 
通过 var 声明 和 直接 赋值 的 变量 。 这 一 点 经 第 被 人 遗忘 ， 而 村 块 化 编程 的 一 个 重要 原则 丈 是 
避免 使 用 全 局 变量 ， 所 以 我 们 在 任何 地 方 都 不 应 该 隐 式 定义 变量 。 














A2 HE 


闭 包 (closure ) 是 因数 式 编 程 中 的 概念 ， 出 现 于 20 世纪 60 年 代 ， 最 早 实现 财 包 的 语言 
是 Scheme， 它 是 LISP 的 一 种 方言 。 之 后 财 包 特性 被 其 他 语言 广泛 吸纳 。 

BERRE E “AKR (环境 ) 及 其 封闭 的 目 由 变量 组 成 的 集合 体 。 这 个 定义 对 
于 大 家 来 说 有 些 星 深 难 懂 ， 所 以 让 我 们 先 通 过 例子 和 不 那么 严格 的 解释 来 说 明 什 么 是 闭 包 ， 
然后 再 举例 说 明 一 些 财 包 的 经 典 用 途 。 











A.2.1 什么 是 闭 包 


通俗 地 讲 ，JavaScript 中 每 个 的 函数 都 是 一 个 财 包 ， 但 通 筑 意义 上 藤 套 的 函数 更 能 够 体 
现 出 财 包 的 特性 ， 请 看 下 面 这 个 例子 : 


var generateClosure = function() ( 
var count = 0; 
var get - function() ( 


count ++; 
return count; 
Jg 
return get; 


> 


var counter = generateClosure(); 
console.log(counter()); // 输出 1 
console.log(counter()); // 输出 2 
console.log(counter()); // 输出 3 


这 段 代 人 码 中 ，generateClosure() 图 数 中 有 一 个 局 部 变量 count， 初 值 为 0。 还 有 一 
个 叫做 get 的 函数 ，get 将 其 父 作 用 域 ， 也 就 是 generateClosure O KURAJ count 变 
量 增加 1， 并 返回 count 的 值 。generateclosure() 的 返回 值 是 get 图 数 。 在 外 部 我 们 
通过 counter 变量 调用 了 generateCclosure() 图 数 并 获取 了 它 的 返回 值 , 也 就 是 get PR 
数 ， 接 下 来 反复 调用 几 次 counter () ， 我 们 发 现 每 次 返回 的 值 都 递增 了 1。 

让 我 们 看 看 上 面 的 例子 有 什么 特点 ， 按 照 通常 命令 式 编 程 思维 的 理解 ，count 是 
generateClosure RAUN ER] AE E , 它 的 生命 周期 就 是 generateClosure 被 调用 的 时 
期 ， 当 generateClosure 从 调用 栈 中 返回 时 ，count 变量 申请 的 空间 也 就 被 释放 。 问 题 
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f. 在 generateClosure() 调用 结束 后 ， counter() 却 引 用 了 “已 经 释放 了 的 ” count 
变量 ， 而 且 非 但 没有 出 错 ， 反 而 每 次 调用 counter () 时 还 修改 并 返回 了 count. WEG 
么 回 事 呢 ? 

这 正 是 所 谓 闭 包 的 特性 , 当 一 个 了 闻 数 返回 它 内 部 定义 的 一 个 也 数 时 ,就 产生 了 一 个 财 包 ， 
闭 包 不 但 包括 被 返 回 的 函数 ， 还 包括 这 个 函数 的 定义 环境 。 上 面 例子 中 ， 当 也 数 
generateClosure() 的 内 部 男 数 get 被 一 个 外 部 变量 counter 引用 时 ，counter 和 
generateClosure() 的 局 部 变量 就 是 一 个 财 包 。 如 采 还 不 够 清晰 ， 下 面 这 个 例子 可 以 帮助 
你 理解 : 


var generateClosure = function() ( 
var count = 0; 
var get - function() ( 


count ++; 
return count; 
js 
return get; 


}3 


var counter] = generateClosure(); 
var counter2 - generateClosure(); 
console.log(counter1()); // 输出 1 
console.log(counter2()); // 输出 1 
console.log(counter1()); // 输出 2 
console.log(counter1()); // 输出 3 
console.log(counter2()); // 输出 2 
































上 面 这 个 例子 解释 了 闭 包 是 如 何 产生 的 : counteri 和 counter2 分 别 调 用 了 generate- 
Closure() 图 数 ， 生 成 了 两 个 财 包 的 实例 ， 它 们 内 部 引用 的 count 变量 分 别 属 于 各 目的 
运行 环境 。 我 们 可 以 理解 为 , 在 generateClosure() 返回 get 图 数 时 ， 私 下 将 get 可 
能 引用 到 的 generateclosure() 图 数 的 内 部 变量 (也 就 是 count 变量 ) 也 返回 了 ， 并 
在 内 存 中 生成 了 一 个 副本 ， 之 后 generateClosure () 返回 的 函数 的 两 个 实例 counter1 
和 counter2 就 是 相互 独立 的 了 。 











A.2.2 HEAR 


1. BEES BS [el JS ers 2t 

财 包 有 两 个 主要 用 途 ， 一 是 实现 座 套 的 回调 函数 ， 二 是 隐藏 对 象 的 细节 。 让 我 们 先 看 下 
面 这 有 段 代码 示例 ， 了 解 般 登 的 回调 也 数 。 如 下 代码 是 在 Node.js 中 使 用 MongoDB 实现 一 个 
简单 的 增加 用 户 的 功能 : 
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exports.add user = function(user info, callback) { 
var uid - parseInt(user info['uid']); 
mongodb.open(function(err, db) { 
if (err) {callback (err); return;] 
db.collection('users', function(err, collection) { 
if (err) {callback (err); return;] 
collection.ensureIndex("uid", function(err) { 
if (err) {callback (err); return;]) 
collection.ensureIndex("username", function(err) { 
if (err) {callback (err); return;]) 
collection.findOne((uid: uid}, function(err) { 


if (err) (callback(err); return;)j 
if (doc) 4 

callback('occupied'):; 
j else ( 

var user - ( 


uid: uid, 
user: user info, 
ld 
collection.insert(user, function(err) { 


callback(err); 


如 果 你 对 Node.js 或 MongoDB 不 熟悉 ， 没 关系， 不 需要 去 理解 细 方 ， 只 要 看 清楚 大 概 
的 逻辑 即 可 。 这 上 段 代 人 码 中 用 到 了 闭 包 的 层 层 航 侠 ， FARER EA EYKA EE eK 
数 不 会 立即 执行 ， 而 是 等 待 相 应 请 求 处 理 完 后 由 请 求 的 函数 回调 。 我 们 可 以 看 到 ,在 航 僚 的 
每 一 层 中 都 有 对 callback 的 引用 ， 而 且 最 里 层 还 用 到 了 外 层 定义 的 uid 变量 。 由 于 闭 包 
机 制 的 存在 ， 即 使 外 层 函 数 已 经 执行 完毕 ， 其 作用 域内 申请 的 变量 也 不 会 释放 ,因为 里 层 的 
哨 数 还 有 可 能 引用 到 这 些 变 量 ， 这 样 就 完美 地 实现 了 骸 侄 的 异步 回调 。 
































Ws 尽管 可 以 这 么 做 ， 上 面 这 种 回调 函数 深层 谋 套 的 实现 并 不 优 关 ， 本 书 
提示 。 第 6 章 中 介绍 了 控制 流 优化 的 方法 。 


2. 实现 私有 成 员 

我 们 知道 ，JavaScript 的 对 象 没 有 私有 属性 ， 也 就 是 说 对 象 的 每 一 个 属性 都 是 曝露 给 外 部 
的 。 这 样 可 能 会 有 安全 隐患 ， 璧 如 对 象 的 使 用 者 直接 修改 了 某 个 属性 ， 导 致 对 象 内 部 数据 的 一 
致 性 受到 破坏 等 。JavaScript 通 过 约定 在 所 有 私有 属性 前 加 上 下 划 线 ( 例如 _myPrivateProp )， 
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表示 这 个 属性 是 私有 的 ， 外 部 对 象 不 应 该 下 接 读 写 它 。 但 这 只 是 个 非 正式 的 约定 , 假设 对 象 
的 使 用 者 不 这 人 么 做 ， 有 没有 更 严格 的 机 制 呢 ? 答案 是 有 的 ， 通 过 闭 包 可 以 实现 。 让 我 们 再 看 
看 前 面 那 个 例子 : 








var generateClosure = function() { 
var count = 0; 
var get - function() ( 


Count ++; 
return count; 
)4 
return get; 


13 


var counter - generateClosure(); 
console.log(counter()); // 输出 1 
console.log(counter()); // 输出 2 
console.log(counter()); // 输出 3 


我 们 可 以 看 到 ， 只 有 调用 counter () 才能 访问 到 闭 包 内 的 count 变量 ， 并 按照 规则 
对 其 增加 1， 除 此 之 外 决 无 可 能 用 其 他 方式 找到 count 变量 。 受 到 这 个 简单 例子 的 局 发 ， 
我 们 可 以 把 一 个 对 象 用 闭 包 封装 起 来 , 只 返回 一 个 “访问 妖 ” 的 对 象 , 即 可 实现 对 细节 隐藏 。 
关于 实现 JavaScript 对 象 私有 成 员 的 更 多 信息 ， 请 参考 http:/javascript.crockford.comy/private.html 。 


A3 对象 


提起 面 癌 对 象 的 程序 设计 语言 ， 立 刻 让 人 想起 的 是 CH, Java 等 这 类 静态 强 类 型 语言 ， 
VA Python, Ruby 等 脚本 语言 ， 它 们 共有 的 特点 是 基于 类 的 面 问 对 象 。 而 说 到 JavaScript, 
很 少 能 让 人 想到 它 面 回 对 象 的 特性 ， 甚 至 有 人 说 它 不 是 面 回 对 象 的 语言 ， 因 为 它 没 有 类 。 没 
AB. JavaScript 真 的 没有 类 ， 但 JavaScript 是 面向 对 象 的 语言 。JavaScript HU ox S, EZ 
是 对 象 ， 不 是 类 的 实例 。 

因为 绝 大 多 数 面 回 对 象 语言 中 的 对 象 都 是 基于 类 的 , 所 以 经 党 有 人 混 消 类 的 实例 与 对 象 
的 概念 。 对 象 束 是 类 的 实例 ， 这 在 大 多 数 语言 中 都 没 错 ， 但 在 JavaScript 中 却 不 适用 。 
JavaScript 中 的 对 象 是 基于 原型 的 , 因此 很 多 人 在 初学 JavaScript 对 象 时 感到 无 比 困惑 。 通 过 
这 一 节 ， 我 们 将 重新 认识 JavaScript 中 对 象 ， 充 分 理解 基于 原型 的 面向 对 象 的 实质 。 












































A.3.1 创建 和 访问 

JavaScript 中 的 对 象 实际 上 就 是 一 个 由 属性 组 成 的 关联 数组 ， 属 性 由 名 称 和 值 组 成 ， 值 
的 类 型 可 以 是 任何 数据 类 型 , 或 者 函数 和 其 他 对 象 。 注意 JavaScript 具有 了 郴 数 式 编程 的 特性 ， 
所 以 函数 也 是 一 种 变量 ， 大 多 数 时 候 不 用 与 一 般 的 数据 类 型 区 分 。 
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在 JavaScript 中 ， 你 可 以 用 以 下 方法 创建 一 个 简单 的 对 象 : 


var foo = {}; 

LOOSDEOD 1 = 'bar'; 
foo.prop 2 - false; 
foo.prop 3 = function() ( 


return 'hello world'; 


} 


console.log(foo.prop_3()); 


以 上 代码 中 ， 我 们 通过 var foo = {}; 创建 了 一 个 对 象 ， 并 将 其 引用 赋值 给 foo. 
通过 foo .prop1 来 获取 它 的 成 员 并 赋值 , 其 中 {} 是 对 象 字 面 量 的 表示 方法 , 也 可 以 用 var 
foo = new Object() 来 显 式 地 创建 一 个 对 象 。 

1. 使 用 关联 数组 访问 对 象 成 员 

我 们 还 可 以 用 关联 数组 的 模式 来 创建 对 象 ， 以 上 代码 修改 为 : 











var foo = {}; 

foo['prop1'] e 'bar'; 
foo['prop2'] = false; 
foo['prop3'] = function() { 


return 'hello world'; 


} 

在 JavaScript 中 ， 使 用 句点 运算 符 和 关联 数组 引用 是 等 价 的 ， 也 就 是 说 任何 对 象 ( 包括 
this 指针 ) 都 可 以 使 用 这 两 种 模式 。 使 用 关联 数组 的 好 处 是 ， 在 我 们 不 知道 对 象 的 属性 名 
称 的 时 候 ， 可 以 用 变量 来 作为 关联 数组 的 索引 。 例 如 : 





var some prop = 'prop2'; 
foo[some prop] - false; 


2. 使 用 对 象 初始 化 器 创建 对 象 
上 述 的 方法 只 是 让 你 对 JavaScript 对 象 的 定义 有 个 了 解 , 真正 在 使 用 的 时 候 , 我 们 会 采用 
下 面 这 种 更 加 紧凑 明了 的 方法 : 


var foo = ( 
"propl'zs 'bar', 
prop2: 'talse', 
prop3: function ()( 
return 'hello world'; 
j 
H 


这 种 定义 的 方法 称 为 对 象 的 初始 化 希 。 注 意 , 使 用 初始 化 名 时 ， 对 象 属性 名 称 是 否 加 引 
号 是 可 选 的 ,除非 属性 名 称 中 有 空格 或 者 其 他 可 能 造成 疏 义 的 字符 , 否则 没有 必要 使 用 3 引号。 
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A.3.2 构造 函数 


前 一 人 小节 讲述 的 对 象 创建 方法 都 有 一 个 弱点 ， 就 是 创建 对 象 的 代码 是 一 次 性 的 。 如 果 我 
们 想 创建 多 个 规划 好 的 对 象 ， 有 寿 干 个 固定 的 属性 、 方 法 ， 并 能 够 初始 化 ， 就 像 C++ 语言 
中 的 对 象 一 样 ， 该 如 何 做 呢 ?” 别 担心 ，JavaScript 提供 了 构造 晒 数 ， 让 我 们 来 看 看 应 该 如 何 
创建 复杂 的 对 象 。 


function User (name, uri) ( 
this.name - name; 
this.uri = uri; 
this.display = function() { 
console.log(this.name); 
】 
j 


以 上 是 一 个 简单 的 构造 函数 ， 接 下 来 用 new 语句 来 创建 对 象 : 





var someuser = new User('byvoid', 'http://www.byvoid.com'); 
然后 就 可 以 通过 someuser 来 访问 这 个 对 象 的 属性 和 方法 了 。 
A.3.3 上 下 文 对 象 


在 JavaScript F, E F3 SE this 指针 ， 即 被 调用 男 数 所 处 的 环境 。 上 下 文 对 象 
的 作用 是 在 一 个 函数 内 部 引用 调用 它 的 对 象 本 身 ，jJavaScript 的 任何 函数 都 是 被 某 个 对 象 调 
用 的 ,包括 全 局 对 象 ， 所 以 chis 指针 是 一 个 非常 重要 的 东西 。 


















e. JavaScript 中 并 没有 像 C++ 一 样 的 指针 概念 ， 这 里 所 谓 的 this 指针 
提示 只 是 活用 习惯 的 说 法 而 已 。 








在 前 面 使 用 构造 函数 的 代码 中 我 们 已 经 看 到 了 cnis 的 使 用 方法 ， 下 面 代码 可 以 更 佳 清 
楚 地 说 明 上 下 文 对 象 的 使 用 方式 : 


var someuser = { 
name: 'byvoid', 
display: function() ( 
console.log(this.name); 
j 
Hi 


someuser.display(); // 输出 byvoid 


var foo - ( 
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bar: someuser.display, 
name: 'foobar' 


23 
foo.bar(); // 输出 foobar 


JavaScript 的 吨 数 式 编 程 特性 使 得 本 数 可 以 像 一 般 的 变量 一 样 赋 值 、 传 递 和 计算 ， 我 们 
看 到 在 EHRE F, foo XJZ&BJ bar 属性 是 someuser. display PRA, 使 用 foo.bar() 
调用 时 ，lbar 和 foo 对 象 的 函数 看 起 来 没有 区 别 ， 其 中 的 this 指针 不 属于 某 个 因数 ， 而 
是 函数 调用 时 所 属 的 对 和 象 。 

在 JavaScript 中 ， 本 质 上 ， 郴 数 类 型 的 变量 是 指 加 这 个 纯 数 实体 的 一 个 引用 ， 在 引用 之 
间 赋 值 不 会 对 对 象 产生 复制 行为 。 我 们 可 以 通过 六 数 的 任何 一 个 引用 调用 这 个 函数 , 不 同 之 
处 仅仅 在 于 上 下 文 。 下 面 例子 可 以 帮助 我 们 理解 : 




















var someuser = { 
name: 'byvoid', 
func: function() ( 
console.log(this.name); 
} 
H 


var foo = { 
name: 'foobar' 


I3 
someuser.func(); // 输出 byvoid 


foo.func = someuser.func; 
foo.func(); // 输出 foobar 


name 'global'; 


func = someuser. func; 
func(); // 输出 global 


仔细 观察 上 面 的 例子 ,使 用 不 同 的 引用 来 调用 同一 个 函数 时 ，this 指针 永远 是 这 个 引 
用 所 属 的 对 象 。 在 前 面 的 章节 中 我 们 提 到 了 JavaScript 的 函数 作用 域 是 静态 的 ， 也 就 是 说 一 
个 冰 数 的 可 见 匈 围 是 在 预 编 详 的 语法 分 析 中 就 可 以 确定 的 , 而 上 下 文 对 象 则 可 以 看 作 是 静态 
作用 域 的 补充 。 

1. call 和 apply 

在 JavaScript 中 ，call 和 apply 是 两 个 神奇 的 方法 ,但 同时 也 是 容易 令 人 迷惑 的 两 个 
方法 ， 帮 至 许多 对 JavaScript 有 经 验 的 人 也 不 太 清 楚 它 们 的 用 法 。call 和 apply 的 功能 是 
以 不 同 的 对 象 作 为 上 下 文 来 调用 有 某 个 函数 。 侧 而 言 之 , 束 是 允许 一 个 对 象 去 调用 为 一 个 对 象 
的 成 员 函 数 。 乍 一 看 似乎 很 不 可 思议 ， 而 且 容 易 引 起 混乱 ， 但 其 实 JavaScript 并 没有 严格 的 
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所 谓 “ 成 员 函 数 ”的 概念 ， 函 数 与 对 象 的 所 属 关 系 在 调用 时 才 展 现 出 来 。 灵 活 使 用 call 和 
apply 可 以 市 省 不 少时 间 ， 在 后 面 我 们 可 以 看 到 ，call 可 以 用 于 实现 对 和 象 的 继承 。 

call 和 apply 的 功能 是 一 致 的 ， 两 者 细微 的 差别 在 于 call 以 参数 表 来 接受 被 调用 画 
数 的 参数 ， 而 apply 以 数组 来 接受 被 调用 函数 的 参数 。call 和 apply 的 语法 分 别 是 : 





func.call (thisArg[, argl[, arg2[, ...]111]) 
func.apply (thisArg[, argsArray]) 


其 中 ，func 是 函数 的 引用 ，thisaArg 是 func 被 调用 时 的 上 下 文 对 象 ，arg1l1、arg2 或 
argsArray 是 传人 func 的 参数 。 我 们 以 下 面 一 段 代码 为 例 介 绍 call 的 工作 机 制 : 


var someuser = { 
name: 'byvoid', 


display: function(words) ( 


console.log(this.name + ' says ' + words); 
} 
Ja 
var foo = { 
name: 'foobar' 
}; 
someuser.display.call(foo, 'hello'); // 输出 foobar says hello 


用 Node.js 运行 这 段 代码 ,我 们 可 以 看 到 欣 制 全 输出 了 £oobarosomeuser.display 是 
被 调用 的 图 数 ， 它 通过 call 将 上 下 文 改 变 为 foo 对 象 ， 因 此 在 图 数 体内 访问 this.name 
时 ， 实 际 上 访问 的 是 foo.name， 因 而 输出 了 foobar。 

2. bind 

如 何 改 变 被 调用 函数 的 上 下 文 呢 ?” 前 面 说 过 , 可 以 用 call 或 apply 方法 , 但 如 果 重 复 
使 用 会 不 方便 ， 因 为 每 次 都 要 把 上 下 文 对 象 作为 参数 传递 ,而 且 还 会 使 代码 变 得 不 下 观 。 针 
对 这 种 情况 ,我 们 可 以 使 用 bina 方法 来 永久 地 绑 定 函数 的 上 下 文 ， 使 其 无 论 被 谁 调 用 ， 上 
下 文 都 是 固定 的 。bing 语法 如 下 : 








func.bind(thisArg[, argl[, arg2[, ...]]]) 

其 中 func 是 竺 绑 定 图 数 ，thisaArg 是 改变 的 上 下 文 对 象 ，argl1、arg2 是 绑 定 的 参 
Mko bind 方法 返回 值 是 上 下 文 为 thisArg HJ func。 通 过 下 面 例子 可 以 帮 你 理解 bind 
的 使 用 方法 : 








var someuser = { 
name: 'byvoid', 
func: function() ( 
console.log(this.name); 
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var foo = ( 


name: 'foobar' 


foo.func = someuser.func; 
foo.func(); // 输出 foobar 


foo.füuncl = someuser.func.bind(someuser): 
foo.funcil(); // 输出 byvoid 


func = someusser.';tunc.bind(froo); 
func(); // 输出 foobar 


func2 = func; 
func2(); // 输出 foobar 


上 面 代码 直接 将 fe. TUnc 赋值 为 someuser .func， 调 用 foo. func() 时 ，this 指 
EFX foo, 所 以 输出 结果 是 foobar, foo. funci 使 用 了 bind 方法 ， 将 someuser 作 
为 this 指 针 绑 定 到 someuser.func, 调用 £oo.funci() 时 ，this 指 针 为 someuser, 
所 以 输出 结果 是 pyvoid。 全 局 限 数 func 同样 使 用 了 bina 方法 , 将 foo 作为 tnis 指 
EtA ETI] someuser.func, 调用 func() hf, this 指针 为 £oo, 所 以 输出 结果 是 foobar。 
而 func2 直接 将 绑 定 过 的 func 赋值 过 来 ,与 func 行为 完全 相同 。 

3. 使 用 bina 绑 定 参 数 表 

bind 方法 还 有 一 个 重要 的 功能 : 绑 定 参数 表 ， 如 下 例 所 示 。 








var person = { 
name: 'byvoid', 
says: function(act, obj) ( 


console.log(this.name + ' ' + act + ' ' + obj); 
j 
); 
person.says('loves', 'diovyb'); // 输出 byvoid loves diovyb 
byvoidLoves - person.says.bind(person, 'loves'); 
byvoidLoves('you'); // 输出 byvoid loves you 


可 以 看 到 ，pyvoidaLoves 将 this 指针 绑 定 到 了 person， 并 将 第 一 个 参数 绑 定 到 
loves， 之 后 在 调用 byvoidLoves 的 时 候 ， 只 需 传 人 第 三 个 参数 。 这 个 特性 可 以 用 于 创建 
一 个 函数 的 “捷径 > ， 之 后 我 们 可 以 通过 这 个 “捷径 ”调用 ， 以 便 在 代码 多 处 调用 时 省 略 重 
复 输入 相同 的 参数 。 
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4. 理解 bind 
KE bind 很 优美 ， 还 是 有 一 些 令 人 迷惑 的 地 方 ， 例 如 下 面 的 代码 : 


var someuser = ( 
name: 'byvoid', 
func: function () { 


console.log(this.name); 
j 
P3 


var foo - ( 

name: 'foobar' 
Ji 
func = someuser.func.bind (foo); 
func(); // 输出 foobar 
func2 = func.bind(someuser); 
func2(); // 输出 foobar 


ARA func 通过 someuser .func.bindqd 将 this 指 针 绑 定 到 了 foo， 调 用 func () 输 
出 了 foobar。 我 们 试 岁 将 func2 赋 值 为 已 绑 定 的 func 重 新 通过 binq 将 this 指 针 绑 定 到 
someuser 的 结果 ,而 调用 func2 时 却 发 现 输出 值 仍 为 foobar, 即 this 指针 还 是 停留 在 foo 
对 和 象 上 ， 这 是 为 什么 呢 ?” 要 想 解释 这 个 现象 ， 我们 必须 了 解 bina 方法 的 原理 。 

让 我 们 看 一 个 bind 方法 的 简化 版 本 《不 文 持 绑 定 参数 表 ): 














someüuser.ftunc.bind = function(selt) 4 
return this.calliselrt)s 
i4 
假设 上 面 图 数 是 someuser.func HJ bina Z;i1EHJ3CXAÀ, PAZRURPE] tnis 指 癌 的 是 
someusetr .func， 因 为 图 数 也 是 对 象 ， 所 以 this.call(self) 的 作用 就 是 以 self 作为 
this 指 针 调 用 someuser. func。 





// 将 func = someuser.func.bind(foo) 展 开 : 
func = function() { 
return someuser.func.call(foo); 


J3 


/ /再 将 Enme2 = func.bind(someuser)/&7Ff: 
func2 = function() { 
return func.call(í(someuser); 


} . 


从 上 面 展 开 过 程 我 们 可 以 看 出 ，func2 实际 上 是 以 someuser 作为 func 的 this 指 
针 调 用 了 func, mM func 根本 没有 使 用 this 指针 ， 所 以 两 次 bina 是 没有 效果 的 。 
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A.3.4 ”原型 


原型 是 JavaScript Wü epe] RRE PEZES, ULZEON ZONA HUE. JESUS 
数 的 面 品 对 象 语言 中 ， 对 和 象 是 基于 类 的 (例如 Java 和 C++ )， 对象 是 类 实例 化 的 结果 。 而 在 
JavaScript 语 言 中 ， 没 有 类 的 概念 "， 对 象 由 对 象 实例 化 。 打 个 比方 来 说 ， 基 于 类 的 语言 中 类 
就 像 一 个 模具 ,对象 由 这 个 模具 浇注 产生 ,而 基于 原型 的 语言 中 ,原型 就 好 像 是 一 件 艺 术 品 
的 原件 ， 我 们 通过 一 台 10096 精确 的 机 硕 把 这 个 原件 复制 出 很 多 份 。 

前 面 小 节 的 例子 中 都 没有 涉及 原型 ， 仅 仅 通 过 构造 吨 数 和 new 语句 生成 类 ， 让 我 们 看 
看 如 何 使 用 原型 和 构造 函数 共同 生成 对 象 。 








function Person() { 

} 

Person.prototype.name = 'BYVoid'; 
Person.prototype.showName = function () ( 


console.log(this.name); 


I3 


var person - new Person(); 
person.showName(); 


Eri Bef CR f HT Y Jg 8 vlr A Js] 38s PRIUS Ttt o6] e o SUPE ABL ECPETETATIS PRU] AE C 
属性 有 什么 不 同 呢 ? 

O 构造 旺 数 内 定义 的 属性 继 湖 方 式 与 原型 不 同 , 子 对 象 需要 显 式 调 用 父 对 象 才能 继 藉 构 
X PAŽIN E A JS TEE 

O 构造 函数 内 定义 的 任何 属性 , 包括 函数 在 内 部 会 被 重复 创建 , 同一 个 构造 函数 产生 的 
两 个 对 象 不 共享 实例 。 

a 构造 限 数 内 定义 的 函数 有 运行 时 闭 包 的 开销 ,因为 构造 水 数 内 的 局 部 变量 对 其 中 定义 
的 函数 来 说 也 是 可 见 的 。 

下 面 这 段 代码 可 以 验证 以 上 问题 : 

















function Foo() { 
var innerVar = 'hello'; 
thig.propl = 'BYVo1id':; 
this.funcil = function()( 
innerVar - '' 
Ja 
】 
FEoo .Drototype .Prop2 = 'OCarbo*'; 
Foo.prototype.func2 = function () ( 


console.log(this.prop2); 


CD 很 多 时 候 对 象 的 构造 函数 会 被 称 为 “类 ”， 但 实际 上 并 不 是 严格 意义 上 的 类 。 
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i 


var fool - new Foo(); 
var foo2 - new Foo(); 
console.log(fool.funcl1 == foo2.func1); // 输出 false 
console.log(fool.func2 == foo2.func2); // 输出 true 








AEW, FAEERE PROCU BEES PCIE, MERAK ENE MARNI 
什么 时 候 使 用 原型 ， 什 么 时 候 使 用 构造 函数 内 定义 来 创建 属性 呢 ? 

a 除非 必须 用 构造 也 数 团 包 ， 否 则 尽量 用 原型 定义 成 员 函 数 ， 因 为 这 样 可 以 减少 开销 。 

口 尽量 在 构造 郴 数 内 定义 一 般 成 员 , 尤其 是 对 象 或 数组 , 因为 用 原型 定义 的 成 员 是 多 个 














实例 共 至 的 。 
接 下 来 ， 我 们 介绍 一 下 JavaScript 中 的 原型 链 机 制 。 
原型 链 


JavaScript 中 有 两 个 特殊 的 对 象 : Object 与 Function, 它们 都 是 构造 也 数 ， 用 于 生 
成 对 象 。 Object.prototype 是 所 有 对 象 的 祖先 ， Function.prototype ES KAHJE 
A, WAER RHE JavaScript 中 的 对 象 分 为 三 类 ， 一 类 是 用 户 创建 的 对 象 ， 一 类 是 构 
造 曾 数 对 象 ， 一 类 是 原型 对 象 。 用 户 创建 的 对 象 ， 即 一 般 意 义 上 用 new 语句 显 式 构造 的 对 
象 。 构 造 郴 效 对 象 指 的 是 普通 的 构造 吨 数 ， 即 通过 new 再 用 生成 普通 对 象 的 函数 。 原 型 对 象 
特 指 构造 函数 prototype 属性 指 回 的 对 象 。 这 三 类 对 象 中 每 一 类 都 有 一 个 — proto — JB 
性 ， 它 指 回 该 对 象 的 原型 ， 从 任何 对 象 治 着 它 开 始 轴 历 都 可 以 退 溯 到 object .prototype- 
TERORA prototype 属性 ， 指 同一 个 原型 对 象 ， 通 过 该 构造 函数 创建 对 象 时 ， 被 创 
建 对 象 的 __proto__ 属 性 将 会 指向 构造 另 数 的 prototype 属性 。 原型 对 象 有 constructor 
属性 ， 指 问 它 对 应 的 构造 函数 。 让 我 们 通过 下 面 这 个 例子 来 理解 原型 . 











function Foo() { 

} 

Object.prototype.name = 'My Object'; 
Poo.protoLype.name = 'Bar'; 

var obj new Object(); 
var foo new Foo(); 

console.log(obj.name); // 输出 My Object 
foo.name); // 输出 Bar 

foo. proto  .name); // 输出 Bar 


console.log 
console.log 


console.log(foo. proto . proto  .name); // 输出 My Object 














console.logtftoo. . proto. »constructorlprototype.name)s // 输出 Bar 


我 们 定义 了 一 个 叫做 roo 0 BR PRAG, 生成 了 对 象 foo。 同 时 我 们 还 分 别 给 object 
和 Foo 生成 原型 对 象 。 
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图 A-1 解析 了 它们 之 间 错 综 复 杂 的 关系 。 


-—— a O 


constructor 


Foo.prototype 











. proto _ 


constructor 


Object Object.prototype 
| wo 


图 A-1 JavaScript 原型 之 间 的 关系 


在 JavaScript 中 ， 继 承 是 依靠 一 套 叫 做 原型 链 (prototype chain ) 的 机 制 实现 的 。 属 性 
继承 的 本 质 就 是 一 个 对 象 可 以 访问 到 它 的 原型 链 上 任何 一 个 原型 对 象 的 属性 。 例 如 上 例 的 
foo XZ, EWA foo. | proto _ 和 foo. proto _. proto ”所 有 属性 的 浅 找 
Vi (只 复制 基本 数据 类 型 ， 不 复制 对 象 所 以 可 以 直接 访问 {foo Constructor (3E H LOO: 
__proto . ， BlFoo.prototype J; too.tosbrind ( 3€ E foo. __proto . x... DEOLO. ， 


Function.prototype 






Bllobject.prototvype )。 


A.3.5 ”对象 的 复制 


JavaScript 和 Java 一 样 都 没有 像 C 语 言 中 一 样 的 指针 ， 所 有 对 象 类 型 的 变量 都 是 指向 对 
象 的 引用 ， 两 个 变量 之 间 赋 值 传递 一 个 对 象 并 不 会 对 这 个 对 象 进 行 复制 ， 而 只 是 传递 引用 。 
有 些 时 候 我 们 需要 完整 地 复制 一 个 对 象 ， 这 该 如 何 做 呢 ? Java 语言 中 有 clone 方法 可 以 实 
现 对 象 复制 ,但 JavaScript 中 没有 这 样 的 函数 。 因 此 我 们 需要 手动 实现 这 样 一 个 函数 ， 一 个 
简单 的 做 法 是 复制 对 象 的 所 有 属性 : 
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Object.prototype.clone = function() ( 
var newObj = (); 
for (var i in this) ( 
newObj[i] = this[i| 
j 


return newObj; 


var obj = ( 
name: 'byvoid', 
likes: ['node'] 
上 了 
var newObj = obj.clone(); 


obj.likes.push('python'); 


console.log(ob].likes); // 输出 [ 'node', "'python' ] 
console.log(newObj.likes); // 输出 [ 'node', 'python' ] 


上 上 面 的 代码 是 一 个 对 象 浅 拷 贝 《shallow copy) 的 实现 ， 即 只 复制 基本 类 型 的 属性 ， 而 
共享 对 象 类 型 的 属性 。 浅 拷贝 的 问题 是 两 个 对 象 共计 对 象 闫 型 的 属性 , 例如 上 例 中 1ikes 属 
性 指 回 的 是 同一 个 数组 。 

实现 一 个 完全 的 复制 ， 或 深 找 贝 (deep copy ) 并 不 是 一 件 容易 的 事 ， 因 为 除了 基本 数据 

类 型 ， 还 有 多 种 不 同 的 对 象 ， 对 和 象 内 部 还 有 复杂 的 结构 ， 因 此 知 要 用 递归 的 方式 来 实现 : 








Object.prototype.clone = function() ( 
var newObj = (9); 
for (var i in this) ( 


if (typeof(this[i]) -- 'object' || typeof(this[i]) -- 'function') { 
newObj[i] = this[il.clone(); 
j else ( 
newObj[i] = this[il; 
j 
j 
return newObj; 
13 
Array.prototype.clone = function() { 
var newArray - []; 
for (var i = 0; i < this.length; i++) { 
if a E == 'object' || typeof(this[i]) == 'function') { 
newArray[i] - s[i]l.clone(); 
j else ( 
newArray[i] = this[il; 


} 


return newArray; 
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Je 


Function.prototype.clone = function() { 
var that = this; 
var newFunc = function() ( 


return that.apply(this, arguments); 
F? 
for (var i in this) ( 
newFunc[i] = this[i]l; 
j 
return newFunc;ó 


jo 


var obj - ( 
name: "byvoid!'; 
likes: ['node'], 
display: function() ( 


console.log(this.name); 
Fy 
i3 





var newObj - obj.clone(); 

newObj.likes.push('python'); 

console.log(obj.likes); // 输出 [ 'node' ] 
console.log(newObj.likes); // 输出 [ 'node', 'python' ] 
console.log(newObj.display == obj.display); // 输出 false 








上 面 这 个 实现 看 起 来 很 完美 , 它 不 仅 递归 地 复制 了 对 象 复杂 的 结构 ,还 实现 了 函数 的 深 
拷贝 。 这 个 方法 在 大 多 数 情况 下 都 很 好 用 ， 但 有 一 种 情况 它 却 无 能 为 力 ， 例 如 下 面 的 代码 : 





var obj1 = ( 
ref: null 


F3 


var obj2 = ( 
ref: obj1 
}; 


objl.ref = obj2; 


这 段 代 码 的 逻辑 非常 简单 ， 就 是 两 个 相互 引用 的 对 象 。 当 我 们 试图 使 用 深 拷贝 来 复制 
obji 和 obj2 中 的 任何 一 个 时 ， 问 题 就 出 现 了 。 因 为 深 拷 贝 的 做 法 是 遇 到 对 象 就 进行 递归 
复制 ， 那 么 结果 只 能 无 限 循环 下 去 。 对 于 这 种 情况 ， 简 单 的 递归 已 经 无 法 解决 ， 必 须 设 计 一 
套图 论 算法 ,分 析 对 象 之 间 的 依赖 关系 , 建立 一 个 拓扑 结构 图 , 然后 分 别 依次 复制 每 个 顶点 ， 
并 重新 构建 它们 之 间 的 依赖 关系 。 这 已 经 超出 了 本 书 的 讨论 范围 , 而 且 在 实际 的 工程 操作 中 
几乎 不 会 遇 到 这 种 需求 ， 所 以 我 们 就 不 继续 讨论 了 。 
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并 没有 一 个 官方 的 文档 规定 Node.js 应 用 程序 代码 的 风格 ， 但 Node.js 代 码 分 割 有 着 一 些 
“事实 上 的 约定 ”"， 大 多 数 项 目的 代 人 码 都 一 定 程度 上 芝 循 了 这 一 标准 。 作 为 Node.js 开 发 新 手 ， 
我 认为 有 必要 遵守 这 个 约定 ,以 便于 今后 的 交流 。 追 根 漳 源 ， 这 个 规范 发 币 于 Node.js 核 心 模 
块 的 实现 ， 而 Node.js 核 心 模块 的 代码 很 大 程度 上 符合 JavaScript 代 人 码 的 一 贯 风格 。 

事实 上 代码 风格 永远 是 一 个 有 和 争议 的 话题 ， 没 有 什么 最 好 的 ， 也 不 可 能 被 所 有 人 认可 。 
我 们 在 这 一 章节 介绍 的 规范 主要 参考 “Felix’s Node.js Style Guide" ( http://nodeguide.com/ 
style.html )， 其 中 不 仅 有 代码 风格 上 的 规范 ， 也 有 JavaScript 特 性 选择 和 设计 模式 上 的 建议 ， 
这 些 建议 都 是 经 验 之 谈 , 并 非 必须 遵守 , 但 可 能 会 让 你 的 程序 避免 很 多 意外 的 错误 和 性 能 损 
失 。 让 我 们 开始 介绍 吧 。 








B.1 jut 


在 早期 的 语言 规范 中 ， 大 多 数 都 选择 用 Tab 作 为 缩 进 标记 ， 如 Delphi、Microsoft C++ 规 
范 等 。 但 近年 来 , 空格 缩 进 依靠 其 风格 的 不 变性 ,逐渐 成 为 了 主流 。 如 Python 、Ruby 甚 至 C# 
都 采用 了 空格 缩 进 作为 “标准 ?。 但 我 们 选择 两 空格 作为 Nodejs 代 码 的 缩 进 标记 ,不 同 于 最 
常见 的 四 空格 缩 进 。 这 是 因为 Node.js 代 码 中 很 容易 写 出 深层 的 函数 舱 套 , 过 多 的 空格 会 给 阅 
读 吝 来 不 便 ， 因 此 我 们 选择 两 空格 缩 进 。 

正确 的 缩 进 : 








function func(boolVar) { 
if (boolVar) ( 
console.log('True'); 
j else ( 
console.log('False'); 
j 
} 。 


TH ER TI AfE UE : 


function func (boolVar) 
i 
if (boolVar) 
{ 
console.log('True'); 
j 
else 
i 
console.log('False'); 


} 
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尽管 现在 你 的 显示 器 屏幕 可 能 已 经 很 宽 了 ， 但 为 了 保证 在 任何 设备 上 都 可 以 方便 地 阅 
读 ， 我 们 建议 把 行 宽 限 制 为 80 个 字符 。 
B.3 ”语句 分 隔 符 


JavaScript 不 仪 支持 像 C 语 言 一 样 的 分 号 ( ; ) 作为 语句 之 间 的 分 隔 符 ， 还 文 持 像 Python 
语言 那样 的 换行 作为 语句 之 间 的 界限 。 我 们 建议 一 律 使 用 分 号 ， 哪怕 一 行 只 有 一 个 语句 ， 也 
不 要 和 省略 分 号 。 


正确 的 语 名 分隔: 

var a - 1; 

var b = "world's 

var c = function(x) { 
console.log('hello ' + x + a); 

H 

eI 

错误 的 语句 分 隔 : 

var a = 1 

var b = 'world' 

var c = function(x) { 
console.log('hello ' + x + a) 

j 

ci») 


B.A 变量 定义 





永远 使 用 var 定义 变量 ， 而 不 要 通过 赋值 隐 式 定义 变量 。 因 为 通过 赋值 隐 式 定义 的 变 
量 总 是 全 局 变量 ,会 造成 命名 空间 污染 。 我 们 建议 绝 不 使 用 全 局 变量 ， 因 此 要 通过 var 把 
所 有 变量 定义 为 局 部 变量 。 

使 用 var 定义 变量 时 ， 确 保 每 个 语句 定义 一 个 变量 ， 而 不 要 通过 逗号 〈( ，) 把 多 个 变 














正确 的 变量 定义 格式 : 
var foo; 

var bar; 

var arr [40, 'foo']; 


var obj 


EA 
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错误 的 变量 定义 格式 : 





var foo, bar; 
[40, 'foo'], 
m T. 


var arr 


obj 


B.5 变量 名 和 属性 名 


我 们 使 用 小 驼峰 式 命 名 法 (lower camel case ) 作为 所 有 变量 和 属性 的 命名 规则 ， 不 建议 
使 用 任何 单字 母 的 变量 名 。 
正确 的 命名 : 





var yourName = 'BYVoid'; 
错误 的 命名 : 


var YourName = 'BYVoid'; 
/ /或 者 


var your name = 'BYVoid'; 


B.6 ”函数 


JavaScript 具 有 函数 式 编程 的 特性 , 因此 函数 本 质 上 和 一 般 的 变量 没有 区 别 , 对 于 一 般 的 
阴 数 我 们 同样 使 用 小 驼峰 式 命名 法 。 但 对 于 对 象 的 构造 郴 数 名 称 〈 或 者 不 严格 地 说 “类 ”的 
名 称 )， 我 们 使 用 大 驼峰 式 命名 法 (upper camel case )， 也 称 为 Pascal 命 名 法 。 

规定 函数 名 与 参数 表 之 间 规 定 无 空格 ,参数 表 和 括号 ( { 和 } ) 之 间 要 有 一 个 空格 ， 
并 且 在 同一 行 。 

正确 : 





var someFunction = function() (| 
return 'something'; 


i3 
function anotherFunction() { 
return 'anything'; 


J 


function DataStructure() { 


this.someProperty = 'initialized'; 


THUR : 
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var SomeFunction = function() 
{ 
return 'something'; 
Hn 
function another function () ( 
return 'anything'; 


} 


function dataStructure() { 
this.someProperty = 'initialized';] 


B.7 5l* 


JavaScript H 5 s C ) 和 双 引 号 ( " 0 没有 任何 语义 区 别 ， 两 者 都 是 可 用 的 。 我 们 建 
议 一 律 统一 为 单 引号 , 因为 JSON 、XML 都 规定 了 必须 是 双 引 号 , 这 样 便于 无 转 义 地 百 接 引 用 。 

正确 的 引号 用 法 : 

console.log('Hello world.'); 

错误 的 引号 用 法 : 


console,log("Hello world."); 











B.8 关联 数 组 的 初始 化 


将 var = { 放 在 一 行 ， 下 面 每 行 一 对 键 值 ， 保 持 两 空格 的 缩 进 ， 以 分 号 结尾 , }; 最 
后 单独 另 起 一 行 。 对 于 每 对 键 值 , 除非 键 名 之 中 有 空格 或 者 有 非法 字符 , 否则 一 律 不 用 引号 。 
正确 : 


var anObject = { 











name: 'BYVoid', 
website: 'http://www.byvoid.com/', 
'is good': true, 


"FE 
A UA 
var anObject = ('name': 'BYVoid', 
website: 'http://www.byvoid.com/'! 
, "is good": true}; 
B 9 ^^ mm | 
FCU 





尽量 使 用 === 而 不 是 == 来 判断 相等 ， 因 为 == 包含 了 隐 式 类 型 转换 ， 很 多 时 候 可 能 
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与 你 的 预期 不 同 ， 例如 下 面 错 误 的 例子 ， Dum. ee literal 的 值 是 true。 
正确 的 等 号 用 法 : 


var num = 9; 
var literal - '9'; 
If (num === literal) 4 


console.log('Should not be here!!!'); 


} 


错误 的 等 号 用 法 : 


var num = 9; 
var literal - '9'; 
if (num ss literal) { 


console.log('Should not be here!!!'); 


B.10 ”命名 函数 


尽量 给 构造 晒 数 和 回调 男 数 命名 ， 这 样 当 你 在 调试 的 时 候 可 以 看 见 更 清晰 的 调用 栈 。 

对 于 回调 函数 ，Node.js 的 API 和 各 个 第 三 方 的 模块 通常 约定 回调 函数 的 第 一 个 参数 是 馆 
误 对 象 err， 如 果 没 有 人 错误 发 生 ， 其 值 为 undefined。 

正确 : 











req.on('end', function onEnd(err, message) { 
if (err) ( 
console.log('Error.'); 
】 
19 


function FooObj() { 
this.foo = 'bar'; 

j 
"1B 

ESTA: 

req.on('end', function (message, err) { 
if (err === false) { 


console.log('Error.'); 
] 
}); 


var FooObj = function() ( 
this8.loo s 'Dar'; 
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B.11 REX 


尽量 将 所 有 的 成 员 函 数 通 过 原型 定义 , 将 属性 在 构造 函数 内 定义 , 然后 对 构造 函数 使 用 
new 关键 字 创 建 对 象 。 绝 对 不 要 把 属性 作为 原型 定义 ， 因 为 当 要 定义 的 属性 是 一 个 对 象 的 
时 候 , 不 同 实 例 中 的 属性 会 指 癌 同一 地 址 。 除非 必须 , 避免 把 成 员 函 数 定义 在 构造 评 效 内 部 ， 
否则 会 有 运行 时 的 闭 包 开销 。 

正确 : 








function FooObj(bar) { 
/ / ERIE CP A46 10 E 
this.bar = bar; 
this.arr = [1, 2, 3]; 
} 


// 使 用 原型 定义 成 员 涵 数 
FooObj.prototype.func = function() { 
console.log(this.arr); 


E 


var objl1 = new FooObj('obj1'); 
var obj2 = new FooObj('obj32'); 
obj1.arr.push(4); 


objl.func(); // [1, 2, 3, 4] 
obj2.func(); // [1, 2, 3] 
错误 : 


function FooObj(bar) { 
this.bar - bar; 
this.func = function() d 
console.log(this.arr); 


j 

FooObgj.prototype.arr = [1, 2, 31; 
var objl1 = new FooObj('obj1'); 
var obj2 = new FooObj('obj32'); 
objl.arr.;puüsh(4); 


objl.func(); // [1, 2, 3, 4] 
obj2.func(); // [1, 2, 3, 4] 


B.12 继承 
首先 ,避免 使 用 复杂 的 继承 ， 如 多 重 继承 或 深层 次 的 继承 树 。 如 果 的 确 需 要 继承 ,那么 
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尽量 使 用 Node.js 的 uti 1 模块 中 提供 的 inherits 上 因数。 例如 我 们 要 让 Foo 继 承 EventEmitter， 
最 好 使 用 以 下 方式 : 


var util = require('util'); 
var events = require('events'); 


function Foo() { 
} 


util.inherits(Foo, events.EventEmitter); 


x 引 


A 


access log, ( 访问 日 志 ), 83 

ACID, 108 

ActionScript, 9 

applet, 7 

Asynchronous I/O, (异步 式 I/O), 4-5, 29-31 
Atomicity, ( 原子 性 )，108 


B 


Binary JSON, ( BSON), 108 
block, ( BH2€ ), 29, 31 
Blocking T/O, (阻塞 式 IO ), 29 
BOM, (CI vi du EU), 3 


C 


Call Back Function, ( 回调 函数 )，31，34 
Carakan, 9 

Chakra, 9 

child process, 140 

Client JavaScript, 3 

cluster, 140 

CommonJS, 10 

CommonJS Packages, ( CommonJS 包 规范 ), 38 


Comprehensive Perl Archive Network, ( CPAN ), 41 


Consistency, ( 一 致 性 )，108 
console,( 控制 台 )，60~61 
console.error(), 61 


console.log(), 60 





console.trace(), 6l 

Context Object, ( 上 下 文 对 象 )，156 
Cookie, 110-111 

Core JavaScript, 3 

Core Modules,，( 核心 模块 )，132 


CouchDB, 11 
CU, 7 


D 


Deep Clone, ( YRD ), 164 
Django, 2 

Document, ( 文档 )，108 

DOM, (文档 对 象 模型 )，3 

DRY, ( Don't Repeat Yourself )，121 
Durability, ( 持久 性 )，108 





E 


ECMA, (欧洲 计算 机 制造 商 协会 )，8~9 
ECMA-262, 8 

ECMAScript, 8-9 

ejs, ( Embedded JavaScript ), 98-99 
error log, ( 日 志 功 能 ), 138-140 

Event, ( 44 ), 29, 31 

Event Loop, ( 事件 循环 )，29 
EventEmitter.emit(), 64 


EventEmitter.on(), 64 





qu 


EventEmitter.once(), 64 





Ctr 


Fs 


EventEmi 


























EventEmitter.removeListener(), 64 

















events.EventEmitter, 64-65 
exports, 35 
Express, 83-86 


XSLT, ( Extensible Stylesheet Language Transformations, 


可 扩展 样式 表 转 换 语言 )，97 


F 


Field, (字段 )，108 
File Descriptor，( 文件 描述 符 )，67 


ter.removeAllListeners(), 65 


176 索 5| 


File Modules, ( 文件 模块 )，132 L 
Foreign Key, ( / RE), 108 
fs.open, 67 Lexical Scope, ( 语法 作用 域 )，150 
fs.read, 68 Libeio, 6 
fs.readFile, 66 Libev, 6 
fs.readFileSync, 67 Libuv, 6 
FTP，( 文件 传输 协议 )，110 ss 
LiveWire，7 
G Load Caching，( 加 载 缓存 )，134 


Local Mode，( 本 地 模式 )，42 
Global Link, ( 全 局 链接 )，43 
Global Mode, ( 全 局 模式 )，42 M 
Global Object, ( 全 局 对 象 ), 58, 150 


Global Scope, ( 全 局 作用 域 )，150 
Microsoft SQL Server, 108 


Middleware，( 中 间 件 )，97 

















H Module, (模块 )，35 
module.exports, 36-38 

http.ClientRequest, 76 MongoDB, 108 

http.ClientResponse, 77 MVC, (模型 -视图 -控制 器 )，80 

http.createServer, 71 MySQL, 108 

http.get, 76 

http.request, 76 

http.Server, 70 N 

http.ServerRequest, 71 

http.ServerResponse, 74 Nitro, 9 











node modules, 133 

| Node 包 管理 需 ，( Node Package Manager, npm )，41 
Nombas，41 

Index, (ÆE|), 108 Non-blocking IO,《〈 非 阻塞 式 VO ), 29 


IOCP, (Input/Output Completion Port ), 6 NoSQL, (Not Only SQL ), 107 


ISO, ( 国际 标准 化 组 织 )，8 
ISO-16262, 8 O 
Isolation, ( 隔离 性 ), 108 


Once And Only Once，( 一 次 且 仅 一 次 )，121 


J Opera，9 
Oracle, 108 
JaegerMonkey, 9 ORM, (Object Relation Model， 对 象 关系 模型 )，83 
Java applet, 7 
JIT, (Just-in-time Compilation， 即 时 编译 )，3 P 


Package, ( 81), 38-39 
PHP, ( Personal Home Page Tools ), 97 


pear, ( PHP Extension and Application Repository ), 43 
ISOnquerors Pingback, 70 


KJS, 9 


PostereSQL, 108 

Primary Key, ( 主键 ), 108 
process, 58-59 
process.argv, 59 
process.execPath, 60 
process.memoryUsage(), 60 
process.nextTick(), 59 
process.pid, 60 
process.platform, 60 
process.stdin, 59 
process.stdout, 59 
Prototype, (Ji ), 161 
Prototype Chain, ( 原型 链 ), 162 
Python Package Index, (pip ), 42 


Q 


QtScript, 9 


R 


Rails, 83 

Real-time Web, ( 实时 Web ), 2 

REPL, ( Read-eval-printloop, ， 输 入 - 求 值 -输出 循环 )，25 
Request Body, ( 请 求 体 )，72 

Request Header，( 请 求 头 )，72 

request.abort, 76 


p 


request.pause, 77 
request.resume, 77 


p 


request.setEncoding, 77 
request.setNoDelay, 76 
request.setSocketKeepAlive, 76 


+ 


request 








.SetTimeout, 76 





require, 35 

response.end, 74 

response.write, 74 

response.writeHead, 74 

REST, (Representational State Transfer, 
表征 状态 转移 )，94 

Revers Proxy,( 反 回 代 理 )，143 

Rhino, 11 

RingoJS, 11 

Row, (fT), 108 

gem, ( Ruby gems ), 42 


S 


Safari, 9 

ScriptEase, 7 

Semantic Versioning, ( 语义 化 版 本 识别 )，39 
Sequence of Loading,( 加 载 顺 序 ), 134 
Session, ( Zi ), 110 

Shallow Clone, ( #5 ), 164 

Smalltalk, 80 

SpiderMonkey, 9 

SQL, ( Structured Query Language ), 108 
SQLite, 108 

Squirrelfish, 10 

Static Scope, ( 毅 态 作用 域 )，150 

stderr, ( 标准 错误 流 )，60 

stdout,( 标准 输出 流 )，60 

Synchronous I/O, ( 同步 式 W/O ), 4-5, 29-31 


T 


Table, (Æ ), 108 

Telnet, 110 

Template Engine, ( 模板 引擎 )，97 
TraceMonkey, 10 

Transaction, ( 事务 ), 107 

Twitter Bootstrap, 104 


U 


Unique Key, (HE—$£ ), 108 


url.parse, 73 














util.debug(), 63 
util.format(), 63 
util.inherits(), 6l 
util.inspect(), 62 
util.isArray(), 63 
util.isDate(), 63 
util.isError(), 63 
util.isRegExp(), 63 





V 


V8, 3 
View Helper,( 视图 助手 ), 100 
Virtual Host, ( 虚拟 主机 )，143 


177 
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W3C, ( World Wide Web Consortium, 7j ZE|v] E 8d ), 9 
WebKit, 10 
WMLScript, 9 


X 


XSLT, ( Extensible Stylesheet Language Transformations, 


可 扩展 样式 表 转 换 语言 )，97 


Symbols 


一 次 且 仅 一 次 ，(Once And Only Once), 121 

一 致 性 ，( Consistency ), 108 

万 维 网 联盟 ，( World Wide Web Consortium, W3C ), 9 

上 下 文 对 象 ，( Context Object), 156 

中 间 件 ，( Middleware ), 97 

主键 ，( Primary Key )，108 

事件 ，( Event )，29，31 

事件 循环 ，( Event Loop )，29 

事务 ，( Transaction )，107 

会 话 ，( Session ), 110 

全 局 作用 域 ，( Global Scope), 150 

全 局 对 象 ，( Global Object), 58, 150 

全 局 模式 ，( Global Mode), 42 

全 局 链接 ，( Global Link ), 43 

关系 型 数据 库 ，108 

哨 数 作用 域 ，148 

加 载 缓存 ，( Load Caching), 134 

加 载 顺序 ，( Sequence of Loading ), 134 

&, (Package ), 38-39 

Z, (Prototype), 161 

原型 链 ，( Prototype Chain), 162 

原子 性 ，( Atomicity ), 108 

反 回 代理 ，( Reverse Proxy ), 143 

可 扩展 样式 表 转 换 语 言 ,( XSLT，Extensible Stylesheet 
Language Transformations )，97 

同步 式 IO, (Synchronous I/O ), 4—5, 29-31 

回调 函数 ，( Call Back Function ), 31, 34 


MEE, (Foreign Key ), 108 

^E Et, (Field), 108 

实时 Web, (Real-time Web ), 2 

对 象 关 系 模 型 (Object Relation Model , ORM ), 83 
异步 式 IO，( Asynchronous I/O ), 4-5, 29-31 
唯一 键 ，( Unique Key ), 108 

持久 性 ，( Durability ), 108 

控制 台 ，( console )，60~61 

文件 描述 符 ，( File Descriptor )，67 

文件 模块 ，( File Modules ), 132 

文档 ，( Document ), 108 

文档 对 象 模型 ，(DOM )，3 

日 志 功 能 ，(error log )，138~140 

本 地 模式 ，( Local Mode), 42 

标准 输出 流 ，( stdout )，60 

标准 错误 流 ，( stderr )，60 

核心 模块 ，( Core Modules )，132 

模块 ，( Module ), 35 

模型 -视图 -控制 各 ,，( MVC )，80 

ikal, (Template Engine ), 97 

RFA DI, (Shallow Clone ), 164 
浏览 器 对 象 模型 ，(BOM )，3 

RDI, (Deep Clone), 164 

端口 复 用 ，141 

索引 ，( Index )，108 

虚拟 主机 ，( Virtual Host )，143 

fT, (Row), 108 

X, ( Table), 108 

表征 状态 转移 ，( Representational State Transfer , REST ), 94 
视图 助手 ，( View Helper), 100 

访问 日 志 , (access log ), 83 

语法 作用 域 ，( Lexical Scope )，150 

请 求 体 ，( Request Body )，72 

HRK, (Request Header), 72 

险 入 - 求 值 -输出 循环 ，( Read-eval-print loop, REPL ), 25 
阻塞 ，(block )，29，31 

阻塞 式 TO，( Blocking I/O ), 29 

隔离 性 ，( Isolation ), 108 

静态 作用 域 ，( Static Scope), 150 

非 阻塞 式 TO ( Non-blocking I/O ), 29 








“简洁 的 代码 示例 ， 轻 快 的 语言 ， 这 本 书 带 你 进入 同样 
简明 的 Node.js 世 界 。 如 果 你 想 立 即使 用 Node.js 进 行 Web 开 
发 ， 这 里 提供 了 绝 佳 的 指导 。” 


“本 书 是 一 本 浅显 易 懂 的 Node.js 入 门 读物 ， 适 合 有 一 
JavaScript 基 础 的 开发 人 员 阅 读 。 读 过 这 本 书 ， 你 就 完成 了 
从 学 习 Node.js 相 关 知 识 ， 到 使 用 Node.js 构 建 实 际 Web 系 统 
的 全 过 程 。 难 能 可 贵 的 是 ， 本 书 在 讲解 Node.js 的 同时 ， 还 
详细 介绍 了 Web 开 发 领域 的 通用 知识 与 原理 ， 这 些 对 开发 完 
善 健壮 的 Web 应 用 必 不 可 人 少 。” 


“在 CNode 社 区 企盼 将 近 两 年 后 ， 第 一 本 中 文 Node.js 图 
书 终于 诞生 了 。 跟 着 BYVoid 同 学 的 这 本 《Node.js 开 发 指 
南 》， 你 就 会 走 进 Node， 初 探 到 Node 的 好 和 美 。” 


计算 机 /Web 开 发 


Node.js 是 一 种 新 兴 的 开源 技术 ， 它 将 JavaScript 从 Web 
浏览 器 移植 到 常规 的 服务 器 端 ， 使 用 Chrome 的 V8 虚拟 机 来 
解释 和 执行 JavaScript 代 码 ， 能 用 于 构建 高 性 能 、 高 可 扩展 
的 服务 器 和 客户 端 应 用 ， 以 实现 真正 “实时 的 Web 应 用 ”。 
Node.js 在 GitHub 上 吸引 了 大 量 开 发 人 员 的 注意 ， 目 前 已 经 
有 不 少 可 以 直接 引用 的 优秀 模块 。 


Ce DH GE 共 分 6 章 ， 分 别 讨 论 了 
Node.js 的 背景 、 安 装 和 配置 方法 、 基 本 特性 、 核 心 模块 以 及 
开发 实战 ， 人 学 会 如 何 用 
Node.js 编 程 ， 并 了 解 到 事件 驱动 的 异步 式 MO 的 编程 模式 ， 
同时 还 可 以 掌握 一 些 使 用 JavaScript 进 行 函数 式 编程 的 方 
法 。 本 书 非常 适合 想 学 习 新 技术 的 Web 应 用 开发 人 员 阅 读 。 
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